DADiSP Worksheet Functions > A - E > DELUNITS

 

DELUNITS

Purpose:

Deletes a defined unit.

Syntax:

DELUNITS("name")

"name"

-

A string. The full name of the units to remove.

Returns:

1 if successful, else 0.

Example:

defunits("Webers", "V*s", "Wb")

W1: 1..100;setvunits("V")

W2: integ(w1)

u1 = getvunits(w2);delunits("Webers")

W3: integ(w1)

u2 = getvunits(w3)

 

A new unit named Weber with the abbreviation of Wb Is defined. Any series with units of V*s will be reduced to Webers. Since the vertical units of W2 expand to V*s, variable u1 is set to Webers. Next, the units Webers is removed. Now the vertical units of W3 expands to V*s as reported by variable u2.

Example:

W1: 1..100;setvunits("m/sec^2")

 

delunits("g")

W2: 1..100;setvunits("m/sec^2")

 

W1 contains a 100 point series. Although the vertical units are set to m/sec^2, the units are automatically converted to G. By deleting the G unit, the vertical units in W2 remain m/sec^2.

Remarks:

Both built-in and user defined units can be removed, however deleting a built-in unit is generally not recommended.

 

To change the definition of a built-in unit, use DEFUNITS to define a new unit with the same name as the built-in.

See Also:

DEFUNITS

GETHUNITS

GETVUNITS

SETVUNITS

SETXLABEL

SETYLABEL

UNITS