*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.