|
|
In this Topic Hide
| 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 [/temp] [option_spec [option_spec...]] |
| /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. |
| Show [/file filename] [/append filename] [/noindex] [/noHeader] [/plain] |
| [/force] [/clipboard] [/names names] [/width width] expression |
| [expression ...] |
| /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. |
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 [/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.
|