Public Member Functions | List of all members
ParameterList Class Reference

ParameterList class defines common members when specifying each property.
. More...

Inherited by CircuitComponent, Condition, MaterialObject, Step, and StudyProperties.

Public Member Functions

virtual String GetFlagAsString (String &name)
 Returns the settings for the specified properties as a flag property name. More...
 
virtual String GetFlagPropertyHelp (String &propName, Variant &val)
 Returns the help of the flag property as a string for the specified index or name. More...
 
Variant GetKeyNames (String &name)
 Returns the flag name as a string list. More...
 
virtual String GetPropertyHelp (String &propName)
 Returns the help of the flag property as a string for the specified index or name. More...
 
Variant GetPropertyNames ()
 Returns the list of all properties that can be specified for the condition. More...
 
String GetPropertyTable ()
 Returns the list of properties including the type and help. More...
 
virtual String GetPropertyType (String &propName)
 Returns a property type. More...
 
virtual String GetStringValue (String &propName)
 Returns the value of the named property. More...
 
DataSetGetTable (String &propName)
 Returns the value of the specified table property. More...
 
DataSetListGetTableList (String &propName)
 Returns the table list of the specified property. More...
 
virtual double GetValue (String &propName)
 Returns the value of property as a real number. More...
 
virtual double GetValueWithUnit (String &propName, String &unitName)
 Returns the value of the named property as a real number in the specified unit. More...
 
virtual bool IsValid ()
 Returns True if an object is valid. More...
 
virtual void SetComplexValue (String &propName, double real, double imag)
 Specifies the value of the complex property. More...
 
virtual void SetFlagByName (String &propName, String &scriptKeyName)
 Specifies the value of flag property for the specified name. More...
 
void SetTable (String &propName, String array &mat)
 Specifies the value in the specified table for the properties. More...
 
void SetTableFromFile (String &propName, String &filename)
 Specifies a point sequence for a property that is specified, by importing a point sequence file (*.csv, *.txt, *.pa). More...
 
void SetTableList (String &propName, double primaryKey, String &primaryUnitName, String array &mat)
 Specifies the name for the dataset list (multiple tables). More...
 
void SetTableListName (String &propName, String &name)
 Specifies the name for the dataset list (multiple tables). More...
 
void SetTableListWithDualKey (String &propName, double primaryKey, String &primaryUnitName, double secondaryKey, String &secondaryUnitName, String array &mat)
 Specifies a point sequence for the multidimensional array of the specified primary key and secondary key in the dataset list (multiple tables). More...
 
void SetTableProperty (String &propName, DataSet *set)
 Specifies a table for the specified properties. More...
 
void SetTableWithUnit (String &propName, String array &mat, StringList &unitlist)
 Specifies the value of the specified table property. More...
 
void SetTextTable (String &propName, String array &mat)
 Specifies the value in the specified string table for the properties. More...
 
virtual void SetValue (String &propName, Variant &value)
 Specifies the value of the real number property or flag property. More...
 
virtual void SetValueWithUnit (String &propName, double value, String &unitName)
 Specifies the value of the named property. More...
 

Detailed Description

ParameterList class defines common members when specifying each property.
.

The object can be called as a derived object when specifying circuit component, condition, material and study property.
The property names and flags described in Property Name and Flags Used as Arguments are used to specify the properties on each item.

Member Function Documentation

String ParameterList::GetFlagAsString ( String &  name)
virtual

Returns the settings for the specified properties as a flag property name.

Parameters
nameProperty name
Returns
DataSet object (table of properties)
String ParameterList::GetFlagPropertyHelp ( String &  propName,
Variant &  val 
)
virtual

Returns the help of the flag property as a string for the specified index or name.

Parameters
propNameProperty name
valFlag index/Flag name
Returns
Help of the flag property
Variant ParameterList::GetKeyNames ( String &  name)

Returns the flag name as a string list.

Parameters
nameProperty name
Returns
Flag name
String ParameterList::GetPropertyHelp ( String &  propName)
virtual

Returns the help of the flag property as a string for the specified index or name.

Parameters
propNameProperty name
Returns
Help of the property
Variant ParameterList::GetPropertyNames ( )

Returns the list of all properties that can be specified for the condition.

Returns
List of all properties for the condition
String ParameterList::GetPropertyTable ( )

Returns the list of properties including the type and help.

Returns
List of the properties
String ParameterList::GetPropertyType ( String &  propName)
virtual

Returns a property type.

Parameters
propNameProperty name
Returns
Property type
String ParameterList::GetStringValue ( String &  propName)
virtual

Returns the value of the named property.

Parameters
propNameProperty name
Returns
Property value

Reimplemented in StudyProperties.

DataSet * ParameterList::GetTable ( String &  propName)

Returns the value of the specified table property.

Parameters
propNameProperty name
Returns
DataSet (table)
DataSetList * ParameterList::GetTableList ( String &  propName)

Returns the table list of the specified property.

Parameters
propNameProperty name
Returns
DataSetList (table list)
double ParameterList::GetValue ( String &  propName)
virtual

Returns the value of property as a real number.

Parameters
propNameProperty name
Returns
Property value
double ParameterList::GetValueWithUnit ( String &  propName,
String &  unitName 
)
virtual

Returns the value of the named property as a real number in the specified unit.

Parameters
propNameProperty name
unitNameUnit
Returns
Property value
bool ParameterList::IsValid ( )
virtual

Returns True if an object is valid.

Returns
Whether or not the ParameterList objects in the list are valid

Reimplemented in MaterialObject, CircuitComponent, StudyProperties, and Step.

void ParameterList::SetComplexValue ( String &  propName,
double  real,
double  imag 
)
virtual

Specifies the value of the complex property.

The unit that is currently being used is used. A real number value is converted into an integer for the flag property.

Parameters
propNameProperty name
realProperty value (real part)
imagProperty value (imaginary part)
void ParameterList::SetFlagByName ( String &  propName,
String &  scriptKeyName 
)
virtual

Specifies the value of flag property for the specified name.

Parameters
propNameProperty name
scriptKeyNameFlag name
void ParameterList::SetTable ( String &  propName,
String array &  mat 
)

Specifies the value in the specified table for the properties.

Parameters
propNameProperty name
matMultidimensional array
void ParameterList::SetTableFromFile ( String &  propName,
String &  filename 
)

Specifies a point sequence for a property that is specified, by importing a point sequence file (*.csv, *.txt, *.pa).

Parameters
propNameProperty name
filenamePath for file that is imported

The following are example. Creates electric current condition and specifies point sequence for the time dependency current by using a file.

Set cond = study.CreateCondition("Current","current")
Call cond.SetValue("XType","Time")
Call cond.SetTableFromFile("Time","D:\sample_read_csv.csv")

The following file formats can be imported.

  • CSV file (*.csv):
    This file can be edited using Microsoft Excel.
  • Text file (*.txt):
  • Point sequence file (*.pa)
    This is table data that can be exported by JMAG-Studio.
void ParameterList::SetTableList ( String &  propName,
double  primaryKey,
String &  primaryUnitName,
String array &  mat 
)

Specifies the name for the dataset list (multiple tables).

Parameters
propNameProperty name
primaryKeyValue of the primary key
primaryUnitNameUnit name of the primary key
matMultidimensional array
void ParameterList::SetTableListName ( String &  propName,
String &  name 
)

Specifies the name for the dataset list (multiple tables).

Parameters
propNameProperty name
nameDataset list name
void ParameterList::SetTableListWithDualKey ( String &  propName,
double  primaryKey,
String &  primaryUnitName,
double  secondaryKey,
String &  secondaryUnitName,
String array &  mat 
)

Specifies a point sequence for the multidimensional array of the specified primary key and secondary key in the dataset list (multiple tables).

Parameters
propNameProperty name
primaryKeyValue of the primary key
primaryUnitNameUnit name of the primary key
secondaryKeyValue of the secondary key
secondaryUnitNameUnit name of the secondary key
matMultidimensional array
void ParameterList::SetTableProperty ( String &  propName,
DataSet set 
)

Specifies a table for the specified properties.

Parameters
propNameProperty name
setDataSet (table)
void ParameterList::SetTableWithUnit ( String &  propName,
String array &  mat,
StringList &  unitlist 
)

Specifies the value of the specified table property.

Parameters
propNameProperty name
matMultidimensional array
unitlistUnit list
void ParameterList::SetTextTable ( String &  propName,
String array &  mat 
)

Specifies the value in the specified string table for the properties.

Parameters
propNameProperty name
matString multidimensional array
void ParameterList::SetValue ( String &  propName,
Variant &  value 
)
virtual

Specifies the value of the real number property or flag property.

The unit that is currently being used is used. A real number value is converted into an integer for the flag property.

Parameters
propNameProperty name
valueProperty value

Reimplemented in CircuitComponent, and StudyProperties.

void ParameterList::SetValueWithUnit ( String &  propName,
double  value,
String &  unitName 
)
virtual

Specifies the value of the named property.

The unit that is currently being used is used. A real number value is converted into an integer for the flag property.

Parameters
propNameProperty name
valueProperty value
unitNameUnit