Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Items shown between curly braces are parameters that you would configure as part of the call. 

Interface Address

Function

Example

/echo/{message}

Address for server to create, or client to connect

A test location that will return the message:

You Typed: {message}

for whatever was pass in. This location is useful for checking the server is up and responsive.

-a "net.pipe://localhost/PipeReverse"

/projectDirectory/{*projectDirectory}

Ignore units set within project and output base SI units
Directory in which to look for projects
--baseSIUnits

/create

File to load state from when in client mode or file to save state in when in server mode
Starts a new server and returns a {instance} string that should be passed to most other calls to communicate with this created server.
-c "c:\StateFiles\state.txt"

/load?instance={instance}&project={projectName}&scenario={scenarioName}

Directory in which to look for projects-e 2000
Path to the project, or project name on server and optional scenario within that project.
-d "c:\ProjectFiles"

/saveas?instance={instance}&project={projectNewName}&folderPath={folderPath}

Operation timeout for WCF service in seconds.-f "settings.txt"
Save the loaded project after the run is complete to the specified path and file. The string argument cannot be empty, and the path provided must be an existing directory and have saving permissions for the current user. 

/units?instance={instance}&si={useSIUnits}

File to merge command-line settings from.
Ignore units set within project and output base SI units 

/project?instance={instance}

This option allows a plugin (that the project has been saved with) to be loaded for this run only. The path specified is a relative path to the plugin from the command line. eg. "Plugins\ExampleRainfallRunoffModel.dll"
Returns the project file an scenario name of the loaded project
-l "plugin.dll"

/run?instance={instance}

Application mode Client/Server/InProcess.
Executes the active scenario from its current location to the end
-m Client or -m Server

/step?instance={instance}

File to save output into. The extension selects the output format based on the standard TIME I/O formats. A directory of the name specified will be created if the format only supports a single time series.
Moves forward 1 time step in the active scenario
-o "output.res.csv" for CSV or -o "output.nc" 

/getStep?instance={instance}

Path to the project, or project name on server and optional scenario within that project, DateTime values to override the default start and end times of the loaded scenario and data source input set to run.-r "someResult" -r "someOtherResult"

Returns the current step and the total number of steps in the active scenario

-p "projectName.rspr

/metaParameters?instance={instance}

Which results to return. This can appear multiple times.

Info
iconfalse
Note: By default, all recorded results are saved into the specified output file. When this options is used, it only allows you to reduce the number of results saved out. Requested results must be set to record in the project file. To specify the output file name, save the result to a file with a .res.csv extension. Use the column name for the time series.
--step 1

Get the active Functions (also calledmeta-parameter for calibration)

 

/metaParameter?instance={instance}&name={parameterName}&value={value}

Number of time-steps to run.

Set the value of a Function (also calledmeta-parameter for calibration)

 

/allTimeSeries?instance={instance}

Reset the loaded project.
Returns all the result timeseries
--reset

/timeSeries?instance={instance}&name={parameterName}

Return only the current time step's value for the specified results
Returns a specific timeseries
--current

/timeStepValue?instance={instance}&name={parameterName}

Set

returns the last value of a

Function (also called meta-parameter for calibration)

particular timeseries

-v "$metaparam=25", or -v "$anotherMetaParam=2.3"

/reset?instance={instance}

Save
Reset the loaded project
after the run is complete to the specified path and file. The string argument cannot be empty, and the path provided must be an existing directory and have saving permissions for the current user.-y "C:\ProjectFiles\newProject.rsproj"
. 

/finish?instance={instance}

 
Destroys the service associated with the specified instance identifer