CmdLine Mode
Introduction
InterPSS comes with an installer, which installs InterPSS to your computer and creates a link in the program group and on your desktop. By click the link, you can launch InterPSS graphic editor and run InterPSS in the graphic editor mode.
InterPSS also allows you to run in other modes, including command line mode and grid computing mode. You can use the following command to launch InterPSS:
java -classpath ... org.interpss.InterPSS [-o editor|help|cmd] [-g gridgain]
-o
editor run InterPSS in the graphic editor mode
help print InterPSS run help information
cmd run InterPSS in the command line mode
-g
gridgain run InterPSS in the grid computing mode using Gridgain
Cmd Line Mode Options
Synopsis
java -classpath ... org.interpss.InterPSS -o cmd [-g gridgain] -in inputFile
[-run dclf|aclf] [-xml controlFile] [-out outputFile|Console]
[ ... ] indicates the command arguments are optional
| indicates alternative choices.
Options
-o
cmd run InterPSS in cmd line mode. This is the default option, so you can omit it.
-in
<file> simulation input file, its extension will be used to determine the custom data file adapter to load the file
into InterPSS. For example, the IEEE CDF file adapter will be used to load a *.ieee file. The mapping
relationship between file extension and custom data file adapter is defined in
/properties/springConfig/customAdapterContext.xml
ipssdat InterPSS Text File Format
ieee IEEE Common Format
odm IEEE ODM Xml Model
m MatLab Power Flow Data Format
psat PSAT Data Format
uct UCTE Data Exchange Format for LF and SC
psse PSSE Data Format
js InterPSS JavaScripts Scripting File
-run
dclf|aclf To override InterPSS default run type, which is determined by the network object type. Each file contains info
for certain type of study. For example an IEEE CDF file contains info for loadflow study. By default a loadflow
run will be perform. However, you can use -run dclf to force a DC loadflow run.
-xml
<file> Xml file to control the run process. InterPSS defines an XML Schema, which could be used to create XML document
and fully control InterPSS run process. Please see [[Main:InterPSS User Guide: Working with InterPSS XML
Document | InterPSS XML Document]]. The following is a sample XML document to run a Aclf case.
<?xml version="1.0" encoding="UTF-8"?>
<ipss:InterPSS xmlns:ipss="http://www.interpss.org/schema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
<ipss:runStudyCase>
<ipss:analysisRunType>RunAclf</ipss:analysisRunType>
<ipss:runAclfStudyCaseList>
<ipss:runAclfStudyCase>
<ipss:recId>RunAclfCase</ipss:recId>
<ipss:lfMethod>NR</ipss:lfMethod>
<ipss:maxIterations>20</ipss:maxIterations>
<ipss:tolerance>10.0</ipss:tolerance>
<ipss:toleranceUnit>KVA</ipss:toleranceUnit>
<ipss:initBusVoltage>true</ipss:initBusVoltage>
<ipss:diaplaySummary>true</ipss:diaplaySummary>
<ipss:accFactor>0.0</ipss:accFactor>
<ipss:adjustChangeStep>true</ipss:adjustChangeStep>
</ipss:runAclfStudyCase>
</ipss:runAclfStudyCaseList>
</ipss:runStudyCase>
</ipss:InterPSS>
-out
<file Simulation result output file or result to the Console. If this option is not defined, a file with *.ipssout
will be created in the <install root>/output directory.
Customize CmdLine Run Output
Simulation results in a cmd line run is output using a plugin, defined in the /properties/springConfig/customAdapterContext.xml
<bean id="simuResultOutput"
class="org.interpss.output.OutputSimuResultImpl"
scope="prototype"
/>
Document will be created to walk through how to write a custom plugin to output the simulation results in the way you like.