*DataSet()

Creates a data set.

Syntax

*DataSet(ds_name,"ds_label",ds_def,arg_1, arg_2,..., arg_n)

Arguments

ds_name
The variable name of the data set.
Data type: varname
ds_label
The descriptive label of the data set.
Data type: label
ds_def
An existing data set definition.
Data type: DefineDataSet
arg_1, arg_2, ..., arg_n
The arguments being passed to the data set. The number and type of arguments depends on the data set.
Data type: user-defined

Example

*DefineDataSet(dsdef_vehpar)
 *String(model, "Model")
 *Integer(wheelbase, "Wheelbase")
 *Real(spr_mass_cg_hgt, "Sprung Mass CG Height")
 *Real(frnt_spr_mass, "Front Sprung Mass")
 *Real(rear_spr_mass, "Rear Sprung Mass")
 
*EndDefine()
*DataSet(ds_vehpar, "Vehicle Parameters", dsdef_vehpar)
*SetString(ds_vehpar.model, "Sport Utility")
*SetInteger(ds_vehpar.wheelbase, 3000) 
*SetReal(ds_vehpar.spr_mass_cg_hgt, 800.0)
*SetReal(ds_vehpar.frnt_spr_mass, 800.0)
*SetReal(ds_vehpar.rear_spr_mass, 600.0)

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

Properties

Table 1.
Property Returns Data Type Description
label string The descriptive label of the data set.
state boolean Control state (TRUE or FALSE).
varname string The variable name of the data set.

Comments

A data set is a collection of objects of different data types, such as *String(), *Real(), *Integer() and *Option(). The members of a data set can typically be edited or viewed in the interface through a user-defined form.