7.12 Running in command line regime

QuickWave enables running the simulation in a command line regime i.e. using batch file or from external optimisation routine using e.g. Matlab. This feature is prepared mainly for, but is not limited to, use with external optimisers. QuickWave is typically used with its own QW-OptimiserPlus, integrated with QW-Simulator, however, users may also try to couple QuickWave with their own optimising procedures. QW-Editor and QW-Simulator are separate QuickWave units and they have separate command line options defined:

QW-Editor:

·       -pproject_name – Starts the QW-Editor and loads the project specified by its name, project_name (full path must be specified).

·       -i – Enforces iconised operation of QW-Editor.

·       -e – Instructs the QW-Editor to export the project.

·       -q – Instructs the QW-Editor to close.

·       -m – Instructs the QW-Editor to perform the Edit-Select Object operations on the object, which has the same name as project. If this name conditions is not obeyed the modify operation will not be performed. For reasonable application, the corresponding *.udo file describing this object (or some other *.udo and *.txt files called from within this file) should be previously modified by the user/optimiser.

·       -onumber_of_iterations – Instructs the QW-Editor to further instruct the QW‑Simulator to run the analysis for a specified number of iterations. The QW‑Editor will comply by exporting modified files (modifications regarding the RunIter instead of typical Run tasks, specified format of files for saving the results).

·       -w – Instructs the QW-Editor to generate export_warning_map.txt file during exporting the project.

QW-Simulator (unless otherwise specified, file_name denotes the name of a *.ta3, *.pa3 or *.sfr file, and its full path must be specified):

·       -i – Enforces iconised operation of QW-Simulator.

·       -h/? – Starts the QW-Simulator, printing the description of available options in the Simulator Log window.

·       -s file_name – Starts the QW-Simulator, also performing File-Open and Run‑Start commands on the file of specified name file_name.

·       -c file_name – Starts the QW-Simulator, also performing File-Open and Run‑Create commands on the file of specified name file_name.

·       -t file_name – Starts the QW-Simulator, also performing File-Open and Run‑Start commands on the file of specified name file_name. However it does not open any application window. The user has no interaction possibilities, and also any graphical commands within in the tasker will be ignored. Thus for reasonable operation, this option should be used with a tasker file (*.ta3), and the tasker file should contain saving results commands, e.g. Save_S_Results, Save_Antenna_Results, etc.

·       -Inumber –Dedicated to mute/console version of QW-Simulator only. Instructs QW-Simulator to show iterations step every number iterations.

·       -v – Starts the QW-Simulator, printing the version number in the Simulator Log window.

·       -d – Starts the QW-Simulator, printing the licence date expiration and version limitations in the Simulator Log window.

·       -l – Locates the HASP dongle

-              -l1 – enforces link to the local QW HASP dongle

-              -l3 – enforces link of the network QW HASP dongle

·       -o quiet_opt_option – Starts the QW-Simulator in quiet mode (all warnings and errors are saved to the simwarnexit.txt file)

·       -g number – Dedicated to QW-Simulator GPU and QW-Simulator MultiGPU. Instructs QW-Simulator to perform calculations on GPU card with number number. number is a number on Preference list in Preferences dialogue, thus the user needs to set such list before using –g option. In case of calculations on multiple GPU cards, this option instructs QW-Simulator which cards and in what order should be used for the calculations. The following GPU cards numbers should be separated with “;”.

Note that besides the above options, it is also possible to call QW-Simulator from a command line, specifying directly a file name as a parameter. The result of such an operation depends on the file name extension:

·       *.ta3, *.pa3 or *.sfr - Starts the QW-Simulator, also performing the File-Open command on the specified file.

·       *.sh3 - Starts the QW-Simulator, also performing the File-Open, Run-Create and Mesh-TestMesh commands on the specified file. The corresponding *.pa3 file must exist in the project directory.

·       *.da3 - Starts the QW-Simulator, also performing the Results-Saved Results command on the specified file.

·       *.dmp, *.tpl , *.vi3, *.ve3, *.fe3, *.fi3  - Starts the QW-Simulator, also performing the Fields-Saved 2D/3D Fields command on the specified file.

·       *.den, *.de3, *.tpd - Starts the QW-Simulator, also performing the Fields‑Saved 1D Fields command on the specified file.

·       *.fm3  - Starts the QW-Simulator, also performing the Fields-Saved Monitor Fields command on the specified file.

·       *.an3  - Starts the QW-Simulator, also performing the Results-Saved 3D Radiation Pattern command on the specified file.

The above file name extensions can also be registered by the user with the standard Windows system mechanisms.

For example, to run wgtocx1 tasker file from <PUBLICDIR> (see Installation for more details) directory with software version 2017 in standard installation user may run command from standard Windows Run dialogue:

"C:\Program Files\QWED\QW_3D\v2017x64\qwbin\ker1.exe" -s "C:\Users\Public\QWED\ v2017x64\qw_examp\QW_3D\Standard\Wgtocx\wgtocx1.ta3"