Executive
The following properties are part of the command executive
// |
Comment. Command line is ignored. |
? |
Inquiry for property value. Result is put into GlobalReault and can be seen in the Result Window. Specify the full property name. Example: ? Line.Line1.R1 Note you can set this property merely by saying: Line.line1.r1=.058 |
_DoControlActions |
For step control of solution process: Pops control actions off the control queue according to the present control mode rules. Dispatches contol actions to proper control element "DoPendingAction" handlers. |
_InitSnap |
For step control of solution process: Intialize iteration counters, etc. that normally occurs at the start of a snapshot solution process. |
_SampleControls |
For step control of solution process: Sample the control elements, which push control action requests onto the control queue. |
_ShowControlQueue |
For step control of solution process: Show the present control queue contents |
_SolveDirect |
For step control of solution process: Invoke direct solution function in DSS. Non-iterative solution of Y matrix and active sources only. |
_SolveNoControl |
For step control of solution process: Solves the circuit in present state but does not check for control actions. |
_SolvePFlow |
For step control of solution process: Invoke iterative power flow solution function of DSS directly. |
~ |
Continuation of editing on the active object. An abbreviation. Example: New Line.Line1 Bus1=aaa bus2=bbb ~ R1=.058 ~ X1=.1121 |
Abort |
Aborts all the simulations running |
About |
Display "About Box". (Result string set to Version string.) |
AddBusMarker |
Add a marker to a bus in a circuit plot. Markers must be added before issuing the Plot command. Effect is persistent until circuit is cleared. See also ClearBusMarkers command. Example: ClearBusMarkers !...Clears any previous bus markers AddBusMarker Bus=Mybusname code=5 color=Red size=3 You can use any of the standard color names or RGB numbers. See Help on C1 property in Plot command. |
AggregateProfiles |
Aggregates the load shapes in the model using the number of zones given in the argument. Use this command when the number of load shapes is considerably big, this algorithm will simplify the amount of load shapes in order to make the memory consumption lower for the model. The output of this algorithm is a script describing the new load shapes and their application into loads across the model. The argument on this command can be: Actual/pu to define the units in which the load profiles are. Check the OpenDSS user manual for details |
AlinfFile |
Alignfile [file=]filename. Aligns DSS script files in columns for easier reading. |
AllocateLoads |
Estimates the allocation factors for loads that are defined using the XFKVA property. Requires that energymeter objects be defined with the PEAKCURRENT property set. Loads that are not in the zone of an energymeter cannot be allocated. |
AllPCEatBus |
Brings back the names of all PCE connected to the bus specified in the argument. The command goes as follows: AllPCEatBus myBus Where "myBus" is the name of the bus of interest |
AllPDatBus |
Brings back the names of all PDE connected to the bus specified in the argument. The command goes as follows: AllPDEatBus myBus Where "myBus" is the name of the bus of interest |
BatchEdit |
Batch edit objects in the same class. Example: BatchEdit Load..* duty=duty_shape In place of the object name, supply a PERL regular expression. .* matches all names. The subsequent parameter string is applied to each object selected. |
BuildY |
Forces rebuild of Y matrix upon next Solve command regardless of need. The usual reason for doing this would be to reset the matrix for another load level when using LoadModel=PowerFlow (the default) when the system is difficult to solve when the load is far from its base value. Works by invalidating the Y primitive matrices for all the Power Conversion elements. |
Buscoords |
Define x,y coordinates for buses. Execute after Solve or MakeBusList command is executed so that bus lists are defined.Reads coordinates from a CSV file with records of the form: busname, x, y. Example: BusCoords [file=]xxxx.csv |
CalcIncMatrix |
Calculates the incidence matrix of the Active Circuit |
CalcIncMatrix_O |
Calculates the incidence matrix of the Active Circuit. However, in this case the matrix will be calculated considering its hierarchical order,listing the buses starting from the substation to the farthest load in the model |
CalcLaplacian |
Calculate the laplacian matrix using the incidence matrix previously calculated. Before calling this command the incidence matrix needs to be calculated using calcincmatrix/calcincmatrix_o. |
Calcvoltagesbases |
Calculates voltagebase for buses based on voltage bases defined with Set voltagebases=... command. |
Capacity |
Find the maximum load the active circuit can serve in the PRESENT YEAR. Uses the EnergyMeter objects with the registers set with the SET UEREGS= (..) command for the AutoAdd functions. Syntax (defaults shown): capacity [start=]0.9 [increment=]0.005 Returns the metered kW (load + losses - generation) and per unit load multiplier for the loading level at which something in the system reports an overload or undervoltage. If no violations, then it returns the metered kW for peak load for the year (1.0 multiplier). Aborts and returns 0 if no energymeters. |
CD |
Change default directory to specified directory CD dirname |
Check4Updates |
Returns a message indicating if there is a new version of OpenDSS avaialble for download. Requires internet connection. |
Cktlosses |
Returns the total losses for the active circuit in the Result string in kW, kvar. |
Classes |
List of intrinsic DSS Classes. Returns comma-separated list in Result variable. |
Cleanup |
Force execution of the end-of-time-step cleanup functions that samples/saves meters and updates selected state variables such as storage level |
Clear |
Clear all circuits currently in memory. |
ClearAll |
Clears all the circuits and all the actors, after this instruction there will be only 1 actor (actor 1) and will be the active actor |
ClearBusMarkers |
Clear all bus markers created with the AddBusMarker command. |
Clone |
Clones the active circuit. This command creates as many copies of the active cirucit as indicated in the argument if the number of requested clones does not overpasses the number of local CPUs. The form of this command is clone X whereX is the number of clones to be created |
Close |
Opposite of the Open command. |
CloseDI |
Close all DI files ... useful at end of yearly solution where DI files are left open. (Reset and Set Year=nnn will also close the DI files) |
COMHelp |
Shows the documentation file for the COM interface.This file provides guidance on the properties and methods included in the COM interface as well as examples and tips. Use this file to learn more about the COM interface and its different interfaces or just as a reference guide. |
Comparecases |
[Case1=]casename [case2=]casename [register=](register number) [meter=]{Totals* | SystemMeter | metername}. Compares yearly simulations of two specified cases with respect to the quantity in the designated register from the designated meter file. Defaults: Register=9 meter=Totals. Example: Comparecases base pvgens 10 |
Compile |
Reads the designated file name containing DSS commands and processes them as if they were entered directly into the command line. The file is said to be "compiled." Similar to "redirect" except changes the default directory to the path of the specified file. Syntax: Compile filename |
Connect |
Request to create a TCP/IP socket to communicate data with external modules. This function requires the host address and TCP port to connect. |
Currents |
Returns the currents for each conductor of ALL terminals of the active circuit element in the Result string. (See Select command.)Returned as comma-separated magnitude and angle. |
CvrtLoadShapes |
Convert all Loadshapes presently loaded into either files of single or files of double. Usually files of singles are adequate precision for loadshapes. Syntax: cvrtloadshapes type=sng (this is the default) cvrtloadshapes type=dbl A DSS script for loading the loadshapes from the created files is produced and displayed in the default editor. |
DDLLHelp |
Shows the documentation file for the Direct DLL shared library.This file provides guidance on the interfaces included in the DirectDLL shared library. Use this file to learn more about the DirectDLL and its different interfaces or just as a reference guide. |
DI_plot |
[case=]casename [year=]yr [registers=](reg1, reg2,...) [peak=]y/n [meter=]metername Plots demand interval (DI) results from yearly simulation cases. Plots selected registers from selected meter file (default = DI_Totals.CSV). Peak defaults to NO. If YES, only daily peak of specified registers is plotted. Example: DI_Plot basecase year=5 registers=(9,11) no |
Disable |
Disables a circuit element or entire class. Example: Disable load.loadxxx Disable generator.* (Disables all generators) The item remains defined, but is not included in the solution. |
Disconnect |
Request to terminate a TCP/IP socket. This function requires the host address and TCP port to disconnect. |
Distribute |
kw=nn how={Proportional* | Uniform |Random | Skip} skip=nn PF=nn file=filename MW=nn What=[Generator*|Load] Creates a DSS script file to distribute Generator or Load objects on the system in the manner specified by "how". kW = total generation to be distributed (default=1000) how= process name as indicated (default=proportional to load) skip = no. of buses to skip for "How=Skip" (default=1) PF = power factor for new generators (default=1.0) file = name of file to save (default=distgenerators.dss or distloads.dss) MW = alternate way to specify kW (default = 1) What = what type of device to add, Generator (default) or Load |
DOScmd |
Do a DOS command. Sends the command "cmd ... " to Windows. Execute the "cmd /?" command in a DOS window to see the options. To do a DOS command and automatically exit, do DOScmd /c ...command string ... To keep the DOS window open, use /k switch. |
Dump |
Display the properties of either a specific DSS object or a complete dump on all variables in the problem (Warning! Could be very large!). Brings up the default text editor with the text file written by this command. Syntax: dump [class.obj] [debug] Examples: Dump line.line1 Dump solution (dumps all solution vars) Dump commands (dumps all commands to a text file) Dump transformer.* (dumps all transformers) Dump ALLOCationfactors (load allocation factors) Dump Buslist (bus name hash list) Dump Devicelist (Device name hash list) Dump (dumps all objects in circuit) |
Edit |
Edit an object. The object is selected and it then becomes the active object. Note that Edit is the default command. You many change a property value simply by giving the full property name and the new value, for example: line.line1.r1=.04 vsource.source.kvll=230 |
Enable |
Enables a circuit element or entire class. Example: Enable load.loadxxx Enable generator.* (enables all generators) |
Estimate |
Execute state estimator on present circuit given present sensor values. |
Export |
Export various solution values to CSV (or XML) files for import into other programs. Creates a new file except for Energymeter and Generator objects, for which the results for each device of this class are APPENDED to the CSV File. You may export to a specific file by specifying the file name as the LAST parameter on the line. For example: Export Voltage Myvoltagefile.CSV Otherwise, the default file names shown in the Export help are used. For Energymeter and Generator, specifying the switch "/multiple" (or /m) for the file name will cause a separate file to be written for each meter or generator. The default is for a single file containing all elements. May be abreviated Export V, Export C, etc. Default is "V" for voltages. If Set ShowExport=Yes, the output file will be automatically displayed in the default editor. Otherwise, you must open the file separately. The name appears in the Result window. |
ExportOverloads |
Exports the overloads report with the content avaiable at the moment of the call. It only affects the overloads report for the active actor. |
ExportVViolations |
Exports the voltage violations1 report with the content avaiable at the moment of the call. It only affects the voltage violations report for the active actor. |
Fileedit |
Edit specified file in default text file editor (see Set Editor= option). Fileedit EXP_METERS.CSV (brings up the meters export file) "FileEdit" may be abbreviated to a unique character string. |
FinishTimeStep |
Do Cleanup, sample monitors, and increment time. |
FNCSPublish |
Read FNCS publication topics from a JSON file |
Formedit |
FormEdit [class.object]. Brings up form editor on active DSS object. |
Get |
Returns DSS property values set using the Set command. Result is returne in Result property of the Text interface. VBA Example: DSSText.Command = "Get mode" Answer = DSSText.Result Multiple properties may be requested on one get. The results are appended and the individual values separated by commas. See help on Set command for property names. |
GIS |
Executes GIS options working with OpenDSS-GIS. See GIS command help. |
GISCoords |
Define x,y coordinates for buses using real GIS Latitude and Longitude values (decimal numbers). Similar to BusCoords command. Execute after Solve command or MakeBusList command is executed so that bus lists are defined.Reads coordinates from a CSV file with records of the form: busname, Latitude, Longitude. Example: GISCoords [file=]xxxx.csv Note: For using only if OpenDSS-GIS is locally installed. |
HELICSPublish |
Read HELICS publication topics from a JSON file |
Help |
Gives this display. |
Init |
This command forces reinitialization of the solution for the next Solve command. To minimize iterations, most solutions start with the previous solution unless there has been a circuit change. However, if the previous solution is bad, it may be necessary to re-initialize. In most cases, a re-initiallization results in a zero-load power flow solution with only the series power delivery elements considered. |
Interpolate |
{All | MeterName} Default is "All". Interpolates coordinates for missing bus coordinates in meter zone |
LatLongCoords |
Define x,y coordinates for buses using Latitude and Longitude values (decimal numbers). Similar to BusCoords command. Execute after Solve command or MakeBusList command is executed so that bus lists are defined.Reads coordinates from a CSV file with records of the form: busname, Latitude, Longitude. Example: LatLongCoords [file=]xxxx.csv Note: Longitude is mapped to x coordinate and Latitude is mapped to y coordinate. |
Losses |
Returns the total losses for the active circuit element (see Select command) in the Result string in kW, kvar. |
M |
Continuation of editing on the active object. An abbreviation for More |
MakeBusList |
Updates the buslist, if needed, using the currently enabled circuit elements. (This happens automatically for Solve command.) See ReprocessBuses |
MakePosSeq |
Attempts to convert present circuit model to a positive sequence equivalent. It is recommended to Save the circuit after this and edit the saved version to correct possible misinterpretations. |
More |
Continuation of editing on the active object. |
New |
Create a new object within the DSS. Object becomes the active object Example: New Line.line1 ... |
NewActor |
This command creates a new actor (OpenDSS Instance) and sets the new actor as the active actor. There can be only 1 circuit per actor. The NewActor command will increment the variable NumOfActors; however, if the number of actors is the same as the number of available CPUs the new actor will not be created generating an error message. This instruction will deliver the ID of the active actor. This command does not requires a precedent command. |
Next |
{Year | Hour | t} Increments year, hour, or time as specified. If "t" is specified, then increments time by current step size. |
NodeDiff |
Global result is set to voltage difference, volts and degrees, (Node1 - Node2) between any two nodes. Syntax: NodeDiff Node1=MyBus.1 Node2=MyOtherBus.1 |
NodeList |
[Circuit element name] (Optional) Returns a list of node numbers for all conductors of all terminals of the active circuit element in the Result window or interface.If the optional circuit element name is supplied, the program makes it the active element. Usage: NodeList NodeList Line.Myline |
Obfuscate |
Change Bus and circuit element names to generic values to remove identifying names. Generally, you will follow this command immediately by a "Save Circuit Dir=MyDirName" command. |
Open |
Opens the specified terminal and conductor of the specified circuit element. If the conductor is not specified, all phase conductors of the terminal are opened. Examples: Open line.line1 2 (opens all phases of terminal 2) Open line.line1 2 3 (opens the 3rd conductor of terminal 2) |
Panel |
Displays main control panel window. |
Phaselosses |
Returns the losses for the active circuit element (see Select command) for each PHASE in the Result string in comma-separated kW, kvar pairs. |
Plot |
Plots circuits and results in a variety of manners. See separate Plot command help. |
Powers |
Returns the powers (complex) going into each conductors of ALL terminals of the active circuit element in the Result string. (See Select command.)Returned as comma-separated kW and kvar. |
Pstcalc |
Pst calculation. PstCalc Npts=nnn Voltages=[array] dt=nnn freq=nn lamp=120 or 230. Set Npts to a big enough value to hold the incoming voltage array. dt = time increment in seconds. default is 1 freq = base frequency in Hz 50 or 60. Default is default base frequency Lamp= 120 for North America; 230 for Europe. Default is 120 PSTCalc Npts=1900 V=[file=MyCSVFile.CSV, Col=3, Header=y] dt=1 freq=60 lamp=120 |
puvoltages |
Just like the Voltages command, except the voltages are in per unit if the kVbase at the bus is defined. |
Quit |
Shuts down DSS unless this is the DLL version. Then it does nothing; DLL parent is responsible for shutting down the DLL. |
Reconductor |
Reconductor a line section. Must be in an EnergyMeter zone. Syntax: Reconductor Line1=... Line2=... {LineCode= | Geometry = } EditString="..." NPhases=# Line1 and Line2 may be given in any order. All lines in the path between the two are redefined with either the LineCode or Geometry (not both). You may also add an optional string the alter any other line properties. The edit string should be enclosed in quotes or parens or brackets. Nphases is an optional filter on the number of phases in line segments to change. |
Redirect |
Reads the designated file name containing DSS commands and processes them as if they were entered directly into the command line. Similar to "Compile", but leaves current directory where it was when Redirect command is invoked.Can temporarily change to subdirectories if nested Redirect commands require. ex: redirect filename |
Reduce |
{All | MeterName} Default is "All". Reduce the circuit according to reduction options. See "Set ReduceOptions" and "Set Keeplist" options.Energymeter objects actually perform the reduction. "All" causes all meters to reduce their zones. |
Refine_BusLevels |
This function takes the bus levels array and traces all the possible paths considering the longest paths from the substation to the farthest branches within the circuit. Then, the new paths are filled with 0 to complement the oroginal levels proposed by the calcincmatrix_o command. |
RelCalc |
[restore=Y/N]Perform reliability calcs: Failure rates and number of interruptions. Optional parameter: If restore=y automatic restoration of unfaulted section is assumed. |
Remove |
{ElementName=} [KeepLoad=Y*/N] [EditString="..."] Remove (disable) all branches downline from the PDelement named by "ElementName" property. Circuit must have an Energymeter on this branch. If KeepLoad=Y (default) a new Load element is defined and kW, kvar set to present power flow solution for the first element eliminated. The EditString is applied to each new Load element defined. If KeepLoad=N, all downline elements are disabled. Examples: Remove Line.Lin3021 Remove Line.L22 Editstring="Daily=Dailycurve Duty=SolarShape Remove Line.L333 KeepLoad=No |
Rephase |
Generates a script to change the phase designation of all lines downstream from a start in line. Useful for such things as moving a single-phase lateral from one phase to another and keep the phase designation consistent for reporting functions that need it to be (not required for simply solving). StartLine=... PhaseDesignation="..." EditString="..." ScriptFileName=... StopAtTransformers=Y/N/T/F Enclose the PhaseDesignation in quotes since it contains periods (dots). You may add and optional EditString to edit any other line properties. Rephase StartLine=Line.L100 PhaseDesignation=".2" EditString="phases=1" ScriptFile=Myphasechangefile.DSS Stop=No |
ReprocessBuses |
Forces reprocessing of bus definitions whether there has been a change or not. Use for rebuilding meter zone lists when a line length changes, for example or some other event that would not normally trigger an update to the bus list. |
Reset |
{MOnitors | MEters | Faults | Controls | Eventlog | Keeplist |(no argument) } Resets all Monitors, Energymeters, etc. If no argument specified, resets all options listed. |
Rotate |
Usage: Rotate [angle=]nnn. Rotate circuit plotting coordinates by specified angle (degrees). |
Sample |
Force all monitors and meters to take a sample for the most recent solution. Keep in mind that meters will perform integration. |
Save |
{Save [class=]{Meters | Circuit | Voltages | (classname)} [file=]filename [dir=]directory Default class = Meters, which saves the present values in both monitors and energy meters in the active circuit. "Save Circuit" saves the present enabled circuit elements to the specified subdirectory in standard DSS form with a Master.txt file and separate files for each class of data. If Dir= not specified a unique name based on the circuit name is created automatically. If Dir= is specified, any existing files are overwritten. "Save Voltages" saves the present solution in a simple CSV format in a file called DSS_SavedVoltages. Used for VDIFF command. Any class can be saved to a file. If no filename specified, the classname is used. |
Select |
Selects an element and makes it the active element. You can also specify the active terminal (default = 1). Syntax: Select [element=]elementname [terminal=]terminalnumber Example: Select Line.Line1 ~ R1=.1 (continue editing) Select Line.Line1 2 Voltages (returns voltages at terminal 2 in Result) |
SeqCurrents |
Returns the sequence currents into all terminals of the active circuit element (see Select command) in Result string. Returned as comma-separated magnitude only values.Order of returned values: 0, 1, 2 (for each terminal). |
Seqpowers |
Returns the sequence powers into all terminals of the active circuit element (see Select command) in Result string. Returned as comma-separated kw, kvar pairs.Order of returned values: 0, 1, 2 (for each terminal). |
Seqvoltages |
Returns the sequence voltages at all terminals of the active circuit element (see Select command) in Result string. Returned as comma-separated magnitude only values.Order of returned values: 0, 1, 2 (for each terminal). |
Set |
Used to set various DSS solution modes and options. You may also set the options with the Solve command. See "Options" for help. |
SetBusXY |
Bus=... X=... Y=... Set the X, Y coordinates for a single bus. Prerequisite: Bus must exist as a result of a Solve, CalcVoltageBases, or MakeBusList command. |
SetkVBase |
Command to explicitly set the base voltage for a bus. Bus must be previously defined. Parameters in order are: Bus = {bus name} kVLL = (line-to-line base kV) kVLN = (line-to-neutral base kV) kV base is normally given in line-to-line kV (phase-phase). However, it may also be specified by line-to-neutral kV. The following exampes are equivalent: setkvbase Bus=B9654 kVLL=13.2 setkvbase B9654 13.2 setkvbase B9654 kvln=7.62 |
SetLoadAndGenKV |
Set load and generator object kv to agree with the bus they are connected to using the bus voltage base and connection type. |
Show |
Writes selected results to a text file and brings up the default text editor (see Set Editor=....) with the file for you to browse. See separate help on Show command. Default is "show voltages LN Seq". |
Solve |
Perform the solution of the present solution mode. You can set any option that you can set with the Set command (see Set). The Solve command is virtually synonymous with the Set command except that a solution is performed after the options are processed. |
SolveAll |
Solves all the circuits (Actors) loaded into memory by the user |
Summary |
Returns a power flow summary of the most recent solution in the global result string. |
Tear_Circuit |
Estimates the buses for tearing the system in many parts as CPUs - 1 are in the local computer, is used for tearing the interconnected circuit into a balanced (same number of nodes) collection of subsystems for the A-Diakoptics algorithm |
TOP |
[class=]{Loadshape | Tshape | Monitor } [object=]{ALL (Loadshapes only) | objectname}. Send specified object to TOP. Loadshapes and TShapes must be hourly fixed interval. |
TotalPowers |
Returns the total powers (complex) at ALL terminals of the active circuit element in the Result string. (See Select command.)Returned as comma-separated kW and kvar. |
Totals |
Totals all EnergyMeter objects in the circuit and reports register totals in the result string. |
UpdateStorage |
Update Storage elements based on present solution and time interval. |
Userclasses |
List of user-defined DSS Classes. Returns comma-separated list in Result variable. |
Uuids |
Read UUIDs (v4) for class names and other CIM objects. Tab or comma-delimited file with full object name (or key) and UUID. Side effect is to start a new UUID list for the Export CIM100 command; the UUID list is freed after the Export UUIDs command. |
var |
Define and view script variables. Variable names begin with "@" Usage: var @varname1=values @varname2=value2 ... var @varname1 (shows the value of @varname1) var (displays all variabiles and values) Example of using a variable: FileEdit @LastFile |
Variable |
[name=] MyVariableName [Index=] IndexofMyVariable Returns the value of the specified state variable of the active circuit element, if a PCelement. Returns the value as a string in the Result window or the Text.Result interface if using the COM server. You may specify the variable by name or by its index. You can determine the index using the VarNames command. If any part of the request is invalid, the Result is null. |
Varnames |
Returns variable names for active element if PC element. Otherwise, returns null. |
VarValues |
Returns variable values for active element if PC element. Otherwise, returns null. |
Vdiff |
Displays the difference between the present solution and the last on saved using the SAVE VOLTAGES command. |
Visualize |
[What=] one of {Currents* | Voltages | Powers} [element=]full_element_name (class.name). Shows the selected quantity for selected element on a multiphase line drawing in phasor values. |
Voltages |
Returns the voltages for the ACTIVE BUS in the Result string. For setting the active Bus, use the Select command or the Set Bus= option. Returned as magnitude and angle quantities, comma separated, one set per conductor of the terminal. |
Wait |
Pauses the scripting thread until all the active actors are Ready to receive new commands (have finished all their tasks and are ready to receive new simulation orders). |
YearlyCurves |
[cases=](case1, case2, ...) [registers=](reg1, reg2, ...) [meter=]{Totals* | SystemMeter | metername}Plots yearly curves for specified cases and registers. Default: meter=Totals. Example: yearlycurves cases=(basecase, pvgens) registers=9 |
Ysc |
Returns full Ysc matrix for the ACTIVE BUS in comma-separated complex number form G + jB. |
Zsc |
Returns full Zsc matrix for the ACTIVE BUS in comma-separated complex number form. |
Zsc012 |
Returns symmetrical component short circuit impedances Z0, Z1, and Z2 for the ACTIVE 3-PHASE BUS. Determined from Zsc matrix. |
Zsc10 |
Returns symmetrical component impedances, Z1, Z0 for the ACTIVE BUS in comma-separated R+jX form. |
ZscRefresh |
Refreshes Zsc matrix for the ACTIVE BUS. |