Symbol Definition Tags

The following table provides more detailed information about some of the XML tagging used to define the symbols. Note the capitalization of the tags—incorrectly capitalized tags are ignored by XML.

Note: The values available for each tag are specified in the EasyPowerSymbols.xsd template file. You can add or modify these values in the template file, but EasyPower will only recognize those values that were defined in the original template. Modifications that were not part of the original template file are ignored by EasyPower.

Element Tag

Definition

<Equipment Type=”XXXX”>

The type defines the type of equipment –for example, Type = “Utility” means the equipment is a utility.

<GraphicDefinition>

This defines the graphic characteristics of the symbol. It contains sub-elements that provide information such as the points to which a symbol snaps to grid or connects to other equipment. It also specifies:

  • AcadBlockName: Names used for the block when exporting to a DXF file for AutoCAD. The name cannot exceed 32 characters.
  • BreakerState: Open, Closed, ClosedToOpen, OpenToClosed, or Dropped. These sates are used in the Dynamic Stability focus. All breakers, fuses and switches support ClosedToOpen and OpenToClosed. Only low voltage breakers support Dropped.
  • CurrentType: AC or DC.
  • DefaultSpacing: The distance in number of grid points between adjacent symbols.
  • Orientation: AboveBus, BelowBus, Vertical, VerticalFlipped, Horizontal, or HorizontalFlipped. See Symbol Orientation for more information.
  • SubType: Characteristics of the equipment. Most equipment includes a subtype for AC or DC. In addition, the following subtypes are available:
    • Bus: AC, DC, or Node.
    • Generators: AC, DC, Delta, GeneratorModel, ExciterModel, GovernerModel, or GovernerAndExciterModel.
    • Motors: DC, Induction, InductionWithStability, Synchronous, SynchronousWithStability, SynchronousCondenser, SynchronousCondenserWithStability, WithAdjustableFrequencyDrive, or DcWithAdjustableFrequencyDrive.
    • Load: AC, DC, or Harmonic.
    • Panel Schedule and MCC: AC, MainBreaker, or MainFuse.
    • ATS: SourceBusA, SourceBusB. SourceBusAWithStability, SourceBusBWithStability, PrimarySelectorSwitchSourceBusA, PrimarySelectorSwitchSourceBusB.
    • Filter: Notch, FirstOrder, SecondOrder, or ThirdOrder.
    • Low Voltage Breaker: AC, DC, Contactor, or Fused.
    • Fuse: AC, DC, Switch, or Contactor.
    • Current Transformer: PositiveSequence or ZeroSequence.

<SnapPoint>

Determines the location at which the item snaps to grid. Measured in pixels, which are based on 96ppi.

See additional information under <ConnectionPoint>.

For breakers, fuses, and switches, the snap point needs to be centered between the connection point.

Tip: In Tools > Options >One-line Symbols, under Display Options, you can select Show snap points to display the snap points on the one-line.

<ConnectionPoint>

Defines the X and Y coordinates for where the symbol connects to other equipment items on the one-line.

For items such as transformers, there can be multiple connection points, with labels such as "From" and "To."

For current transformers, you can specify the positive and negative connection points. The positive connection represents a connection at the top of the symbol, while a negative represents a connection at the bottom.

Items such as buses do not have connection points due to the ability to change their size.

Connection and Snap Points

For best results, ensure your connection points and snap points are aligned so that the equipment is aligned properly on the snap grid.

For breakers, fuses, and switches, the snap point needs to be centered between the connection point.

Tip: In Tools > Options >One-line Symbols, under Display Options, you can select Show connection points to display the connection points on the one-line.

<ConnectionRectangle> Defines the connection area for an MCC or panel when they are displayed as a rectangle on the one-line.

<WindingSymbolVisibility>

Options are Visible or Hidden. This applies only to a transformer and defines whether the winding symbols (delta, wye, or wye ground) of a transformer symbol are visible.

<WindingSymbolLocation> Defines the location of the transformer winding symbols related to a transformer symbol.

<TextTemplate>

If text appears on the one-line, it is defined here. This controls the location and appearance of the text. You can specify parameters such as:

  • Block (usually, IDName, which is the name of the equipment). Note that some items such as MCCs, panels, and tool points of connection have two blocks of text available to them, which are defined as DataText1 and DataText2.
  • X (horizontal) and Y (vertical) coordinates
  • HorizonalAlignment
  • VerticalAlignment
  • Note: RelativeX="RightSide" is used to make the X (horizontal) attribute value relative to the right side of the symbol so the text block moves when the symbol is resized.

  • Justification
  • Angle
  • Fixed

Note: All closed breakers, switches, and fuses must have a location defined for DataText1. See Data Text for Breakers, Switches, and Fuses for more information.

<SymbolTemplate>

Defines the symbol characteristics. This includes instructions for the shape, size, location, and appearance of the symbol.

Shapes include:

  • Circle. For example, the circle around a motor. See Arcs and Circles for more information.
  • Polygon. For example, the arrow at the bottom of this load symbol: See Polygons for more information.
  • Arc: For example, the arcs in a transformer symbol. See Arcs and Circles for more information.
  • Polyline: For example, the "M" inside a motor symbol. See Polylines for more information.
  • Rectangle: For example, the border around a panel. See Rectangles and Lines for more information.
  • Note: A <PadTemplate> is a rectangle that displays below a bus if the Show Pad Symbol check box is selected in the Bus Data dialog box on the Specifications tab.

  • Line: For example, the base of this utility: (The top of the utility is made up of rectangles.) See Rectangles and Lines for more information.
  • Text: For example, the name "PANEL" inside a panel schedule, which is defined as a Label attribute inside the Text element. See Text for more information.
  • Bezier: For example, the curved lines within an AFD. See Bezier Curves for more information.

More Information

Customizing One-line Symbols Rectangles and Lines
Symbol Template Files Arcs and Circles
Setting Default Custom Symbols for New One-lines Polylines
Editing the Symbol File Polygons
Additional Considerations Text
File Structure Bezier Curves
Coordinates Symbol Orientation
Data Text for Breakers, Switches, and Fuses  
     

www.easypower.com

EasyPower LLC

7730 SW Mohawk St.

Tualatin, OR 97062

(503)655-5059

techsupport@easypower.com

feedback@easypower.com

EasyPower knowledge base

EasyPower Version 10.2

Copyright © 2019 EasyPower LLC. All Rights Reserved.

Help was last updated on 3/22/2019