next up previous contents index
Next: ``Long Text'' Capability Up: The label Button: Create/Edit Previous: Spicetext Labels   Contents   Index


Hypertext

Xic uses a ``hypertext'' mechanism in the representation of property strings and label text in electrical mode. When creating a label, clicking on a connection point in the drawing, for example, will enter a hypertext link to the node into the label. The hypertext is shown in a different color in the prompt line. The label will always display the correct name for the node, should the name subsequently change. This is the means by which node labels can be added to the drawing.

This same capability applies when adding or editing properties from the Property Editor provided by the Properties button in the Edit Menu.

By default, the names of circuit nodes and devices are internally assigned, implying that the name of a particular device or node name of a particular wire net is not well defined. This poses a problem when one wishes to identify a specific device or wire net by name. The hypertext feature addresses this issue, as do the node name mapping and name property assignment features.

The hypertext capability is active when editing a string for a property or label in electrical mode. One inserts a hypertext reference into the text shown on the prompt line by clicking with button 1 in a drawing window, over the object to be referenced. There are three types of reference:

Node Reference
If the user clicks over a wire or on a contact point of a device or subcircuit, a node reference is established. The colored hypertext entered into the prompt line as a response is of the SPICE form ``V(name)'', where name is the node name, which is an integer by default. The string, when printed or shown as a label, will always show the correct name for the node selected.

``Hidden'' target
Some devices have a ``hidden'' target, which is usually shown as a `+' symbol as part of the device schematic representation. The hidden targets are defined in the device definition in the device library file, so that the meaning and location may differ. In the default device library, most two-terminal devices have such a point, which generally returns a branch node or function which specifies the current through the device. For Josephson junctions, the target represents the junction phase. Clicking on this point in a drawing window will insert the corresponding reference.

Name Reference
Clicking within the bounding box of a device or subcircuit, but not over a node or hidden target, will insert a name reference. The returned text is the name of the instance, as derived from the name property attached to the device or subcircuit. This can be applied by the user, to give the device a fixed name. If no name property is applied by the user, Xic will generate one with an internally generated name.

The node references and hidden targets are also the sensitive points when using the plot and iplot commands.

This feature can be used to set up specialized SPICE output. Suppose one wishes to use the save command in WRspice. A spicetext label can be created, where the nodes to be included in the save are inserted in the label by clicking on the drawing. The resulting save command will always save the clicked-on nodes, whether or not the actual node names change.

For another example, suppose one needs to apply a functional dependence to a voltage source in the circuit to the voltage of some node. One would accomplish this with the following procedure.

  1. Open the Property Editor and use the Add menu to initiate addition of a value property.
  2. In the prompt line, type the equation representing the desired functional dependence, and whenever the node voltage text is needed, click on that node in a drawing window.
  3. Press Enter to complete the operation.

The equation should appear in the property label near the voltage source. This could be, for example, ``2*v(4) + v(5)'', if default node names are used. Later, after modifying the circuit, one might notice that the label now reads ``2*v(6) + v(8)''. The internal node numbering has changed due to the modification, but the source still references the correct circuit nodes. This would not be the case if ordinary text was used for the equation string.


next up previous contents index
Next: ``Long Text'' Capability Up: The label Button: Create/Edit Previous: Spicetext Labels   Contents   Index
Stephen R. Whiteley 2006-10-23