Page Comparison

h2. Name

add --- Add a constant value to a dataset or add two datasets together

h2. Syntax
{code:|borderStyle=solid|borderWidth=1|bgColor=#ffffaa}
add hi hiname ;# add active dataset to workspace hiname dataset, result in hiname.

add lo hiname ;# add active dataset to workspace hiname dataset, result in active.

add value ;# add value to active dataset, result in active data.

add x | y | sca value ;# add value to x or y or scalar coordinates.

add x | y | z | sca [value] xx | yy | zz | sca [factor] ;# add data coordinates together.
{code}

h2. Description

The add command will add a constant value to a dataset or add two datasets together. add works on grid and polydata type of dataset. The result dataset is changed.

    * Grid: The two datasets must have the same grid dimensions.
    * Polydata: The two datasets must have the same number of points. For polydata the target for the adding operation can be any of the xyz coordinates and scalar values.
    * Adding two datasets together: The dataset in active is added to the dataset in hiname. The result data is placed in active if the lo argument is used, and in the hiname dataset if the hi argument is used. 


h2. Arguments

*hi* _hiname_
{indent}Add dataset in active and hiname and the result data will be placed in workspace hiname. 
{indent}

*lo* _hiname_
{indent}Add dataset in active and hiname and the result data will be placed in active workspace. 
value
    Add value and result data will be placed in the active workspace. 
{indent}

*hi* | *lo* _hiname_ *tes*
{indent}Add two poly dataset together according to rules above and optionally test using the tesargument if xy coordinates are equal and then add only for equal coordinates. 
{indent}

*x* | *y* | *sca* _value_
{indent}Add value to x or y or scalar coordinates. The result data will be placed in the active workspace. 
{indent}
*x* | *y* | *z* | *sca* \[_value_\] *xx* | *yy* | *zz* \[_factor_\]
{indent}Add value to x or y or scalar coordinates. The result data will be placed in the active workspace. Add data coordinate axes together. Optionally use a value that will be added to the coordinates and/or a factor that will be multiplied with the coordinates. x | y | z | sca represents the first data coordinates and xx | yy | zz represents the second data coordinates. The result is always placed in the first coordinates. 
{indent}

h2. Examples

h3. Ex.1: Add two grids

{noformat:|borderWidth=1|bgColor=#eeeeee}
# Add a grid in active to a grid in workspace named mygrid and place the result in active
add lo mygrid
# Add the value 15 to a dataset in active
add 15
{noformat}

h3. Ex.12: Add coordinates
{noformat:|borderWidth=1|bgColor=#eeeeee}
# Add together x and y data coordinates and place the result in x data coordinates.
add x yy
{noformat}


h2. See also

[sub], [mul], [div]