Command line
You can run your GMDH Shell project in the background mode using the command line. In this mode GMDH Shell works like a command line tool without any interaction with the user.
The easiest way to run GMDH Shell in the background mode is to use the key /auto
.
Example:
"GMDH Shell.exe" c:\Path\FileName.gsp /auto
Host commands
/auto | Runs specified project without user interaction. Example:
"GMDH Shell.exe" c:\MyData\file.gsp /auto |
/save:FileName.gsp | Saves simulation results. Example:
"GMDH Shell.exe" file.gsp /auto /save:result.gsp |
/semiauto | Semi-automatic mode. Same as /auto , but permits interaction with the user. |
/apply:FileName.gsp | Applies models already saved in the project file. Example:
"GMDH Shell.exe" /apply:C:\MyData\project.gsp |
How to recover command-line options from a plug-in
Look into .gsp
project file. Though the file is binary, for your convenience all plug-ins’ settings are kept there in human-readable XML. Find an appropriate section, e.g. <Storage file="BasePlugin" feature="1" description="Time series modeling">
. Important: Despite XML section, .gsp file is binary, do not edit the file!
All settings stored in the XML section are configurable from the command line. For example, command line equivalent of <task>future</task>
is /pr.task:future
.
/im
— importer
/pr
— preprocessor
/ca
— solver
/po
— postprocessor
/ex
— exporter
Some settings are stored in the so-called “shared storage”, accessible to several plug-ins. For example: <Storage name="gs.prepro"><decompositionlimit>0</decompositionlimit>
→ /pr.gs.prepro.decompositionlimit:0
The plug-in may have some extra options not stored in the .gsp
, but listed in the documentation.
Batch-mode export
/noexport | Prevents the export plug-in from exporting simulation results. |
/exportmodels | Exports models as Excel formula. Works for XLS/XLSX only, and some Shell's features do not convert to formulas. Example:
"GMDH Shell.exe" file.gsp /auto /save:result.gsp /exportmodels |
Batch-mode exporter: Export forecast
/ex.file:FPath | Saves result to FPath. Example:
"GMDH Shell.exe" file.gsp /auto /ex.file:C:\MyData\example.txt |
Import
/im.file:FPath | import file from path FPath. Example:
"GMDH Shell.exe" file.gsp /auto /im.file:C:\MyData\example.xls |
Preprocess: Time Series Forecasting
/pr.backtest:n | Number of backtests to simulate = n . |
/pr.skip:n | Skip observations = n . |
/pr.gs.prepro.ts.shift:a,b,c
/pr.horizon:a,b,c | Forecast horizons = a,b,c . |
Preprocess: Value prediction & Classification
/pr.unk:n | Number of unknown values = n . |
/pr.unit:sample | Unit of /pr:unk . Either sample or percent . |
Solver: Combinatorial
/ca.ncpu:n | Number of parallel threads |
Export module
Data Science and Load forecasting editions of GMDH Shell are supplied with an export module that outputs predictions in the command line mode. C++ source codes of the module - a CodeBlocks project is available in the installation directory “..\Plugins\ExportForecast-source.zip”.
The module automatically performs export of predictions when GMDH Shell is launched using the command line. Predictions are saved to simulation_result.txt in the project directory.