Reference

In this Topic Hide

OpenGroup

OpenGroup [/text] [/overwrite] filename

Reads in a data file. There are more options available in addition to the above. Please refer to the Script Reference Manual/Command Reference/OpenGroup for further information.

/text If specified, data file is assumed to be in text format. Otherwise the file is input as a SIMetrix binary data file as saved by the SaveGroup command. See Data Import and Export for details of text format.
/overwrite Forces existing group of the same name to be overwritten. If not specified, the group being read in will be renamed if a group of the same name already exists.
filename Name of file to be input.

OpenGroup creates a new Group. If /text is not specified then the name of the group will be that with which it was stored provided the name does not conflict with an existing group. If there is a conflict the name will be modified to be unique. If /text is specified then the group will be named:

textn

where 'n' is chosen to make the name unique.

Set

Set [/temp] [option_spec [option_spec...]]
Defines an option.

/temp If specified, the option setting will be temporary and will be restored to its original value when control returns to the command line. (i.e when all scripts have completed).
option_spec Can be one of two forms:

Form1: option_name

Form2: option_name = option_value

option_name can be any of the names listed in Options. For options of type Boolean, use form1. For others, use form 2.

See Also

Show

Show [/file filename] [/append filename] [/noindex] [/noHeader] [/plain]
[/force] [/clipboard] [/names names] [/width width] expression
[expression ...]
Displays the value of an expression. This command can be used to export data from the simulator in ASCII form. See Data Import and Export for more details.

/file filename If specified, outputs result to filename. The values are output in a format compatible with OpenGroup /text. (See OpenGroup).
/append filename As /file except that file is appended if it already exists.
/noindex If the vector has no reference, the index value for each element is output if this switch is not specified.
/noHeader If specified, the header providing vector names etc. will be inhibited.
/plain If specified, no index (as /noindex), and no header (as /noHeader) will be output. In addition, string values will be output without enclosed single quotation marks.
/force File specified by /file will be unconditionally overwritten if it exists.
/clipboard Outputs data to system clipboard.
/names names Semi-colon delimited string providing names to be used as headings for tabulated data. If not specified, the vector names are used instead.
/width width Page width in columns for tabulated data. If not specified no limit will be set.
/lock If specified with /file, a lock file will be created while the write operation is being performed. The file will have the extension.lck. This can be used to synchronise data transfers with other applications. The file will be locked for write operations.
expression Expression to be displayed. If expression is an array, all values will be displayed.

Notes

To enter multiple expressions, separate each with a comma.

The display of arrays with a very large number of elements (>500) can take a long time. For large arrays it is recommended that the /file switch is used to output the results to a file. The file can then be examined with a text editor or spreadsheet program.

The results will be tabulated if all vectors are compatible that is have the same x-values. If the any vectors listed are not compatible, each vector's data will be listed separately.

The precision of numeric values can be controlled using the "Precision" option setting. Use the command Set precision = value. This sets the precision in terms of the column width.

Unset

UnSet [/temp] option_name

Deletes specified option. See Options for a full explanation.

/temp If specified, the option setting will be deleted temporarily and will be restored to its original value when control returns to the command line. (i.e when all scripts have completed).
option_name Name of option. This would usually be defined with a value using Set. See Options for a complete list.

Note that most Option values are internal. This means that they always have a value. If such an option is Unset, it will be restored to its default value and not deleted. See Options for more details.

If Unset is called for an option that has not been Set and which is not internal and error will be displayed.