URLs of the following form list the tree variables:
The detail attribute of the returned JSON object is an array of objects. Each object describes a tree variable and has the following attributes:
Name of the treevariable.
Current value of the treevariable.
Units of measure of the tree variable. Note that if this is an empty string the variable should be assumed to be unitless.
Tree variable values may be changed as well as their units:
Note that the units are not optional just as they are not optional for the underlying SpecTcl treevariable -set command.
Treevariables have a flag that indicates if they have been modified in the life of the SpecTcl run. This flag is normally used to limit the amount of information that must be saved in files that capture the SpecTcl analysis state. This flag can be interrogated:
The detail attribute of the returned JSON object is 0 if the variable has not been changed and 1 if it has.
It is possible for user interfaces to directly set the changed flag above. This is done with URLS of the following form:
Finally, there are cases where it's important to fire Tcl traces associated with tree variables. This can be done as follows:
For these URL's, glob-pattern is a GLOB pattern used to filter which traces are fired. Only variables whose names match that pattern will have their traces fired. Note that if not supplied the pattern defaults to * which matches all variable names.