Class: Linespacing

A Linespacing object in OpenDSS defining the physical arrangement (XY coordinates) of conductors in a cross-section, used for geometric impedance calculation.

URI: dss:Linespacing

 classDiagram
    class Linespacing
    click Linespacing href "../Linespacing/"
      Linespacing : AvgNeutralHeight

      Linespacing : AvgPhaseHeight

      Linespacing : detailed

      Linespacing : EqDistPhN

      Linespacing : EqDistPhPh

      Linespacing : h

      Linespacing : like

      Linespacing : name

      Linespacing : nconds

      Linespacing : nphases

      Linespacing : units

      Linespacing : x

Class Properties

Property	Value
Class URI	dss:Linespacing

Slots

Name	Cardinality and Range	Description	Inheritance
name	1 String	Object name	direct
nconds	0..1 Integer	Number of wires in this geometry (phase + neutral conductors)	direct
nphases	0..1 Integer	Number of retained phase conductors (nconds minus neutrals)	direct
x	* Float	Array of wire X coordinates (horizontal position), one per conductor	direct
h	* Float	Array of wire Heights (vertical position), one per conductor	direct
units	0..1 String	Units for x and h: {mi	kft
detailed	0..1 String	{Yes/True	No/False} Default = Yes
EqDistPhPh	0..1 String	Equivalent distance between phase conductors	direct
EqDistPhN	0..1 String	Equivalent distance between phase and neutral conductors	direct
AvgPhaseHeight	0..1 String	Average height of phase conductors	direct
AvgNeutralHeight	0..1 String	Average height of neutral conductors	direct
like	0..1 String	Make like another object, e	direct

Comments

• OpenDSS LineSpacing maps to CIM WireSpacingInfo. Each conductor position is a WirePosition child object (WireSpacingInfo.WirePosition). X and H arrays are converted to meters from the specified units.

Identifier and Mapping Information

Schema Source

• from schema: https://gridappsd.github.io/dss-graph/opendss

Mappings

Mapping Type	Mapped Value
self	dss:Linespacing
native	dss:Linespacing
exact	cim:WireSpacingInfo

LinkML Source

Direct

name: Linespacing
description: A Linespacing object in OpenDSS defining the physical arrangement (XY
  coordinates) of conductors in a cross-section, used for geometric impedance calculation.
comments:
- OpenDSS LineSpacing maps to CIM WireSpacingInfo. Each conductor position is a WirePosition
  child object (WireSpacingInfo.WirePosition). X and H arrays are converted to meters
  from the specified units.
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:WireSpacingInfo
attributes:
  name:
    name: name
    description: Object name. Must be unique per object type.
    comments:
    - Direct name mapping; no conversion needed.
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:IdentifiedObject.name
    identifier: true
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: true
  nconds:
    name: nconds
    annotations:
      order:
        tag: order
        value: 1
    description: Number of wires in this geometry (phase + neutral conductors).
    comments:
    - 'Import: total number of WirePosition children created on the WireSpacingInfo.
      Export: len(WireSpacingInfo.WirePosition).'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    related_mappings:
    - cim:WirePosition
    domain_of:
    - Linegeometry
    - Linespacing
    range: integer
    required: false
    minimum_value: 1
  nphases:
    name: nphases
    annotations:
      order:
        tag: order
        value: 2
    description: Number of retained phase conductors (nconds minus neutrals).
    comments:
    - 'Import: WireSpacingInfo.phaseWireCount = nphases. Export: nphases is recovered
      by counting labeled A/B/C phase conductors on an ACLineSegment that references
      this WireSpacingInfo (falls back to nconds if no such segment is found), since
      phaseWireCount is not read back directly.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WireSpacingInfo.phaseWireCount
    domain_of:
    - Linecode
    - Linegeometry
    - Linespacing
    range: integer
    required: false
    minimum_value: 1
  x:
    name: x
    annotations:
      order:
        tag: order
        value: 3
    description: Array of wire X coordinates (horizontal position), one per conductor.
    comments:
    - 'Import: WirePosition.xCoord = x[i] converted to meters using units. Export:
      x[i] = xCoord in selected units.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WirePosition.xCoord
    domain_of:
    - Linegeometry
    - Linespacing
    - Xycurve
    range: float
    required: false
    multivalued: true
  h:
    name: h
    annotations:
      order:
        tag: order
        value: 4
    description: Array of wire Heights (vertical position), one per conductor.
    comments:
    - 'Import: WirePosition.yCoord = h[i] converted to meters using units. Export:
      h[i] = yCoord in selected units.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WirePosition.yCoord
    domain_of:
    - Linegeometry
    - Linespacing
    range: float
    required: false
    multivalued: true
  units:
    name: units
    annotations:
      order:
        tag: order
        value: 5
    description: 'Units for x and h: {mi|kft|km|m|Ft|in|cm}. Initial default is ft.'
    comments:
    - 'OpenDSS-only (N/A): unit selector consumed during import for x/h conversion
      to meters; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    domain_of:
    - Line
    - Linecode
    - Linegeometry
    - Linespacing
    range: string
    required: false
  detailed:
    name: detailed
    annotations:
      order:
        tag: order
        value: 6
    description: '{Yes/True | No/False} Default = Yes. If No, uses equivalent spacing
      formulas instead of actual geometry.'
    comments:
    - 'OpenDSS-only (N/A): computation mode selector; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    domain_of:
    - Linespacing
    range: string
    required: false
  EqDistPhPh:
    name: EqDistPhPh
    annotations:
      order:
        tag: order
        value: 7
    description: Equivalent distance between phase conductors.
    comments:
    - 'OpenDSS-only (N/A): derived equivalent spacing parameter; not stored on CIM
      WireSpacingInfo.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    domain_of:
    - Linespacing
    range: string
    required: false
  EqDistPhN:
    name: EqDistPhN
    annotations:
      order:
        tag: order
        value: 8
    description: Equivalent distance between phase and neutral conductors.
    comments:
    - 'OpenDSS-only (N/A): derived equivalent spacing parameter; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    domain_of:
    - Linespacing
    range: string
    required: false
  AvgPhaseHeight:
    name: AvgPhaseHeight
    annotations:
      order:
        tag: order
        value: 9
    description: Average height of phase conductors.
    comments:
    - 'OpenDSS-only (N/A): derived average height; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    domain_of:
    - Linespacing
    range: string
    required: false
  AvgNeutralHeight:
    name: AvgNeutralHeight
    annotations:
      order:
        tag: order
        value: 10
    description: Average height of neutral conductors.
    comments:
    - 'OpenDSS-only (N/A): derived average height; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    domain_of:
    - Linespacing
    range: string
    required: false
  like:
    name: like
    annotations:
      order:
        tag: order
        value: 11
    description: 'Make like another object, e.g.: New LineSpacing.S2 like=S1 ...'
    comments:
    - 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
class_uri: dss:Linespacing

Induced

name: Linespacing
description: A Linespacing object in OpenDSS defining the physical arrangement (XY
  coordinates) of conductors in a cross-section, used for geometric impedance calculation.
comments:
- OpenDSS LineSpacing maps to CIM WireSpacingInfo. Each conductor position is a WirePosition
  child object (WireSpacingInfo.WirePosition). X and H arrays are converted to meters
  from the specified units.
from_schema: https://gridappsd.github.io/dss-graph/opendss
exact_mappings:
- cim:WireSpacingInfo
attributes:
  name:
    name: name
    description: Object name. Must be unique per object type.
    comments:
    - Direct name mapping; no conversion needed.
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:IdentifiedObject.name
    identifier: true
    owner: Linespacing
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: true
  nconds:
    name: nconds
    annotations:
      order:
        tag: order
        value: 1
    description: Number of wires in this geometry (phase + neutral conductors).
    comments:
    - 'Import: total number of WirePosition children created on the WireSpacingInfo.
      Export: len(WireSpacingInfo.WirePosition).'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    related_mappings:
    - cim:WirePosition
    owner: Linespacing
    domain_of:
    - Linegeometry
    - Linespacing
    range: integer
    required: false
    minimum_value: 1
  nphases:
    name: nphases
    annotations:
      order:
        tag: order
        value: 2
    description: Number of retained phase conductors (nconds minus neutrals).
    comments:
    - 'Import: WireSpacingInfo.phaseWireCount = nphases. Export: nphases is recovered
      by counting labeled A/B/C phase conductors on an ACLineSegment that references
      this WireSpacingInfo (falls back to nconds if no such segment is found), since
      phaseWireCount is not read back directly.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WireSpacingInfo.phaseWireCount
    owner: Linespacing
    domain_of:
    - Linecode
    - Linegeometry
    - Linespacing
    range: integer
    required: false
    minimum_value: 1
  x:
    name: x
    annotations:
      order:
        tag: order
        value: 3
    description: Array of wire X coordinates (horizontal position), one per conductor.
    comments:
    - 'Import: WirePosition.xCoord = x[i] converted to meters using units. Export:
      x[i] = xCoord in selected units.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WirePosition.xCoord
    owner: Linespacing
    domain_of:
    - Linegeometry
    - Linespacing
    - Xycurve
    range: float
    required: false
    multivalued: true
  h:
    name: h
    annotations:
      order:
        tag: order
        value: 4
    description: Array of wire Heights (vertical position), one per conductor.
    comments:
    - 'Import: WirePosition.yCoord = h[i] converted to meters using units. Export:
      h[i] = yCoord in selected units.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    exact_mappings:
    - cim:WirePosition.yCoord
    owner: Linespacing
    domain_of:
    - Linegeometry
    - Linespacing
    range: float
    required: false
    multivalued: true
  units:
    name: units
    annotations:
      order:
        tag: order
        value: 5
    description: 'Units for x and h: {mi|kft|km|m|Ft|in|cm}. Initial default is ft.'
    comments:
    - 'OpenDSS-only (N/A): unit selector consumed during import for x/h conversion
      to meters; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    owner: Linespacing
    domain_of:
    - Line
    - Linecode
    - Linegeometry
    - Linespacing
    range: string
    required: false
  detailed:
    name: detailed
    annotations:
      order:
        tag: order
        value: 6
    description: '{Yes/True | No/False} Default = Yes. If No, uses equivalent spacing
      formulas instead of actual geometry.'
    comments:
    - 'OpenDSS-only (N/A): computation mode selector; no CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    owner: Linespacing
    domain_of:
    - Linespacing
    range: string
    required: false
  EqDistPhPh:
    name: EqDistPhPh
    annotations:
      order:
        tag: order
        value: 7
    description: Equivalent distance between phase conductors.
    comments:
    - 'OpenDSS-only (N/A): derived equivalent spacing parameter; not stored on CIM
      WireSpacingInfo.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    owner: Linespacing
    domain_of:
    - Linespacing
    range: string
    required: false
  EqDistPhN:
    name: EqDistPhN
    annotations:
      order:
        tag: order
        value: 8
    description: Equivalent distance between phase and neutral conductors.
    comments:
    - 'OpenDSS-only (N/A): derived equivalent spacing parameter; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    owner: Linespacing
    domain_of:
    - Linespacing
    range: string
    required: false
  AvgPhaseHeight:
    name: AvgPhaseHeight
    annotations:
      order:
        tag: order
        value: 9
    description: Average height of phase conductors.
    comments:
    - 'OpenDSS-only (N/A): derived average height; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    owner: Linespacing
    domain_of:
    - Linespacing
    range: string
    required: false
  AvgNeutralHeight:
    name: AvgNeutralHeight
    annotations:
      order:
        tag: order
        value: 10
    description: Average height of neutral conductors.
    comments:
    - 'OpenDSS-only (N/A): derived average height; not stored on CIM.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    rank: 1000
    owner: Linespacing
    domain_of:
    - Linespacing
    range: string
    required: false
  like:
    name: like
    annotations:
      order:
        tag: order
        value: 11
    description: 'Make like another object, e.g.: New LineSpacing.S2 like=S1 ...'
    comments:
    - 'OpenDSS-only (N/A): DSS template/copy directive resolved at parse time; no
      CIM equivalent.'
    from_schema: https://gridappsd.github.io/dss-graph/general/linespacing
    owner: Linespacing
    domain_of:
    - Load
    - Generator
    - Generic5
    - Gicline
    - Indmach012
    - Pvsystem
    - Storage
    - Upfc
    - Vccs
    - Vsconverter
    - Windgen
    - Autotrans
    - Capacitor
    - Gictransformer
    - Line
    - Reactor
    - Transformer
    - Capcontrol
    - Espvlcontrol
    - Expcontrol
    - Fuse
    - Gendispatcher
    - Invcontrol
    - Pycontrol
    - Recloser
    - Regcontrol
    - Relay
    - Storagecontroller
    - Swtcontrol
    - Upfccontrol
    - Cndata
    - Dynamicexp
    - Growthshape
    - Linecode
    - Linegeometry
    - Linespacing
    - Loadshape
    - Priceshape
    - Spectrum
    - TccCurve
    - Tsdata
    - Tshape
    - Wiredata
    - Xfmrcode
    - Xycurve
    - Energymeter
    - Fmonitor
    - Monitor
    - Sensor
    - Fault
    - Gicsource
    - Isource
    - Vsource
    range: string
    required: false
class_uri: dss:Linespacing