Slot: TapNum¶

An integer number indicating the tap position that the controlled transformer winding tap position is currently at.

Applicable Classes¶

Name	Description	Modifies Slot
Regcontrol	A Regcontrol object in OpenDSS representing a voltage regulator control that ...	no

Properties¶

Type and Range¶

Property	Value
Range	Integer
Domain Of	Regcontrol

Cardinality and Requirements¶

Property	Value
### Slot Characteristics

Property	Value
Owner	Regcontrol

Comments¶

Import: RatioTapChanger.step = 1.0 + TapNum × 0.00625 (SSH state; CIM step is a per-unit ratio around 1.0, DSS TapNum is an integer step count from neutral at a fixed 0.625%/step). Export: TapNum = round((step − 1.0) / (stepVoltageIncrement/100)) using the RatioTapChanger's own stepVoltageIncrement if set, otherwise the same 0.625%/step assumption.

Identifier and Mapping Information¶

Annotations¶

property	value
order	28

Schema Source¶

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

Mappings¶

Mapping Type	Mapped Value
self	dss:TapNum
native	dss:TapNum
close	cim:RatioTapChanger.step

LinkML Source¶

name: TapNum
annotations:
  order:
    tag: order
    value: 28
description: An integer number indicating the tap position that the controlled transformer
  winding tap position is currently at.
comments:
- 'Import: RatioTapChanger.step = 1.0 + TapNum × 0.00625 (SSH state; CIM step is a
  per-unit ratio around 1.0, DSS TapNum is an integer step count from neutral at a
  fixed 0.625%/step). Export: TapNum = round((step − 1.0) / (stepVoltageIncrement/100))
  using the RatioTapChanger''s own stepVoltageIncrement if set, otherwise the same
  0.625%/step assumption.'
from_schema: https://gridappsd.github.io/dss-graph/opendss
close_mappings:
- cim:RatioTapChanger.step
rank: 1000
owner: Regcontrol
domain_of:
- Regcontrol
range: integer
required: false