ds

   'ds' [<1.Dataset-Nr> [<2.Dataset-Nr>] [<n.Dataset-Nr>] ->
            ['a[h]'|'e[h]' [<entity-nr> (up to 4 times)]]|
            ['o' <value> [<entity-nr>]]|
            ['p' <power> [<entity-nr>]]|
            ['s' <value> [<entity-nr>]]|
            ['r' <key> [<parm1>] [<parm2>] [..<parm5>]]]|
        ['g' <name> [[<ncomps>|<0>] <value> <text> <type> ->
          <step> <analysisName>]]|
        ['e' <name> <comp> <type> <row> <column>]|
        ['f']

This keyword is used to select, modify or generate one or more Datasets (ds) and one or more Entity (e). In addition it can be used to generate or modify related parameters which might store step specific descriptions. The dataset has to be a positive number which has to match the nr in the Dataset-menu or an 'l' (lower case 'L') which is interpreted as the last available Dataset or a negative number. Then it is interpreted as the last ds minus the specified number. For example

ds 1

will just select the first Dataset and will write some informations about it to stdout and to the ”stack” if active. It will write ds-nr, lc-name, ds-value, ds-text, ds-name, nr-of-entities

ds 1 e 1

will display the first entity of the first Dataset and will write some informations about it to stdout or to the ”stack” if active. It will write ds-nr, lc-name, ds-value, ds-text, ds-name, entity-name.

ds l e 1

will display the last Dataset. To start the animation of the second-to-last Dataset right away:

ds -1 a

Or generate an animated fringe plot by adding the desired entity:

ds -1 a 4

Sequences can be defined by specifying one to three datasets and by extending the 'e' parameter by an 'h' ('history'):

ds 2 eh 1

Here all datasets of the same type as ds 2 are selected. The spacing between datasets of the same type is only evaluated for the first step. A unique step-with is therfore needed.

ds 2 10 eh 1

Here the datasets 2, 10 and all successive ones of the same type with a spacing of 8 are selected.

ds 2 4 10 eh 1

Here the 1st entity of each second Dataset is selected. The selection starts at the second- and ends at the 10th dataset. If more than one entity is defined then a vector-plot will be displayed. If a 4th entity is defined then this entity will be used for the basic color-plot:

ds 2 4 10 eh 12 13 14 15

In case the deformed shape should be shown together with the fringe plot in a sequence of datasets then the 'e' parameter has to be replaced by an 'a' character.

ds 2 ah 1

REMARK: So far vector plots can not use the deformed shape. Therefore only one entity is supported.

In addition, it is possible to scale or offset the entities of the specified datasets:

ds 1 s 1.2

will scale all entities of dataset 1 by a factor of 1.2.

ds 1 p 1.2 3

will use the given exponent to scale entity 3 of dataset 1 by an exponent of 1.2.

ds 1 o 200.

will add a value of 200 to all entities of dataset 1.

ds 1 o 200. 2

will add a value of 200 to the entity 2 of dataset 1. Each dataset might use related parameters (see Parameter Header Record for the format of a parameter record). This parameters can be overwritten or created:

ds 2 4 10 r TAMB 1

Each second dataset from 2 to 10 gets a related parameter 'TAMB' with the value '1'. If the value is nummeric it can be used by the “graph” command.

A new dataset in which all values are initiallized to zero is generated with:

ds g VELOCITY 3

The 'name' VELOCITY will appear in the menu as the dataset name and can be 8 character long. It has 3 components ('ncomps', default is '1'). The other parameters are optional:

• value: A nummeric value, usually time or frequency (used by “graph”).
• text: A describing text (used by “graph”).
• type: Analysis type (static:0,time step:1,frequency:2, etc.).
• step: Step or increment number
• analysisName: Type of analysis (description).

The current dataset name is modified if only the name is given:

ds g VELOCITY

The other parameters of the current dataset can be modified if the number of components is set to zero: ds g VELOCITY 0 1e4 test

The entities of the current dataset are manipulated with:

ds e V 2

The 'name' V will appear in the menu as the entity name and can be 8 character long. It is the second entity (component) of the current dataset (default is '1'). The third and following parameters can be omitted for a scalar.

• name: entity name
• comp: entity nr (component)
• type: Mathematical data type (scalar:1, vector:2, matrix:4, etc.)
• row: sub-component index or row number
• column: column number if matrix

The 'row' paramter defines the location of the enitity in the vector or the row of the matrix. The dataset is finalized with:

ds f

The maximum- and minimum value over all nodes for the current dataset will be determined and stored together with the corresponding node numbers. This values are needed for the graphic display.

The values at the nodes are manipulated with the ”node” command. With that command the new dataset gets its data. See also “How to generate a new dataset” for further details.

More details can be found in section ”Nodal Results Block”.