ChemCAD 5 services to visual basic applications: User Manual, страница 15

Definition        dispinterface IUnitOpSpecUnitConversion

        {

        methods:

short FromInternalUnitsToCurUserUnits(VARIANT specInInternal, VARIANT specInCurUser);

short FromCurUserUnitsToInternalUnits(VARIANT specInCurUser, VARIANT specInInternal);

               short GetUnitOpSpecArrayDimension();

short GetCurUserUnitString(short unitOpID, short parIndex, BSTR* unitString, BSTR* paramName);

               short GetNoOfParameters(short unitOpID);    

        };

Methods          One method need to be called when converting data from current user units to internal units

                        Method             FromCurUserUnitsToInternalUnits        

                        Returns                        number of data items returned

Argument

Type

Description

specInCurUser

specInInternal

Float[]

Float[]

Unit specifications in current user units [in]

Unit specifications in internal units [out]

On the other hand, when converting data from internal units to current user units, user calls

Method             FromInternalUnitsToCurUserUnits        

            Returns                        number of data items returned

Argument

Type

Description

specInInternal

specInCurUser

Float[]

Float[]

Unit specifications in current user units [in]

Unit specifications in internal units [out]

Following the call to FromInternalUnitsToCurUserUnits, user can get the parameter name and unit string by calling

Method             GetCurUserUnitString

                        Returns                        number of data item returned

Argument

Type

Description

unitOpID

parIndex

unitString

paramName

short

short

BSTR

BSTR

Unit ID [in]

Unit specification array index (base one) [in]

Parameter engineering unit string

Name of the parameter

                        or call

            Method             GetNoOfParameters

            Returns                        number of parameters used by the given unit

to find out the actual number of parameters occupied by the specifications for the unit.

Description      IEngUnitConversion interface is a general engineering conversion utility. It performs unit conversions between CHEMCAD 5 internal units and the current user units. The unit categories are defined on the following table.

EngUnit ID

Description

Abbreviation

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21     

22     

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

Molar flow rate

Temperature

Temperature difference

Pressure

Pressure difference

Enthalpy rate

Work rate

Area

Heat transfer coefficient

Heat of reaction

Length

Diameter

Liquid density

Viscosity

Surface tension

Mass flow rate

Crude flow rate

Cake resistance

Solubility

Specific volume

Dipole moment

Vapor density

Volume

Velocity

Medium resistance

Packed column pressure drop

Specific heat capacity (mass base)

Thermal conductivity

Liquid volume rate

Vapor volume rate

Mole (no time)

Mass (no time)

Heat (no time)

Enthalpy/Mole

Enthalpy/Mole or Enthalpy/Mass

Enthalpy/Mass

Fouling factor (reserved)

Heat capacity mole or mass bases

Inverse liquid volume

Time

MOLE

TEMP

DELTAT

PRES

DELTAP

QRATE

WORK

AREA

HTC

HREAC

LEN

DIA

LDEN

VISC

ST

MASS

CRUDE

CAKE

SOL

SVOL

DMOMENT

VDEN

VOL

VEL

MRES

PACKDP

WHEAT

TCOND

LVRATE

VVRATE

WTMOLE

WTMASS

HEAT

MOLEHC

SPHC

MHEAT

FOULF

HEATCAP

ILV

TIME

Definition        dispinterface IEngUnitConversion

        {      

        methods:

short FromInternalUnitToCurUserUnit(short engUnitID, float valueInInternal, float* valueInUser, BSTR* userUnitString);