...
java -cp seamcat.jar org.seamcat.CommandLine myWorkspace.sws |
|---|
Several options are possible. The result file name can be changed by using the option: result=myWorkspaceResults.swr and the number of events can be specified by using the option: events=12345. The example below uses all these parameters:
java -cp seamcat.jar org.seamcat.CommandLine myWorkspace.sws result=myWorkspaceResults.swr events=12345 |
|---|
you will see the following when setting 12 events:
$ java -cp seamcat.jar org.seamcat.CommandLine myWorkspace.sws result=myWorkspaceResults.swr events=12 Initializing log4j with basic configuration [[======================================================================]] Simulated 12 events Simulated performed on: 8 processor Total simulation duration: 0.033 second Event generation duration: 0.03 second Calculation rate: 400 events/second Simulation date: 2020-03-18 17:34:21 Simulation seed: 8425679684002480147 |
|---|
If there is an issue with Java machine memory size, user can increase memory for the simulation, for e.g.
...
java -Xms4069M -Xmx6144M -cp SEAMCAT_5.4.2.jar org.seamcat.CommandLine Workspace="test1.sws" Result="test1run.swr" events=4000 |
|---|
| Parameter | Value | Explanation | Example | Needed | |
|---|---|---|---|---|---|
| Workspace | String | Name and relative path of the workspace | Workspace="Files/WS_PMSE_HH-LTE_UE_Cell_UT.sws" | Obligatory | |
| Result | String | Name and relative path of the result file | Result="Files/Test_OFDMA_DL.swr" | Optional | if not supplied CL will name result file same as Workspace with .swr extension and save it in same folder where workspace is situated |
| events | Integer | Number of events run in the simulation | events = 20000 | Optional | if not supplied CL will run with No events specified in workspace |
| tformat | String | Terrain data format used in the terrain calculations Recognized tformat strings:
| tformat=SRTM_1as_bil_v3 | Optional | If not supplied CL will notify user of missing this parameter and use settings from workspace |
| tpath | String | Absolute path of the terrain data files used for the terrain calculations | tpath="C:\Users\zeljko.tabakovic\OneDrive - ECO\Work Folders_One\SEAMCAT_new\Digital Terrain_bil\SRTM1" | Optional | If not supplied CL will notify user of missing this parameter and use settings from workspace |
| license | String | On the first run of the new version of SEAMCAT, program asks for confirmation of the license. With license parameter, user can explicitly accept license in command line. | license=accept | Optional |
Extracting vector results from the workspace results
Once your simulation is done, you can either open the .swr results file from the SEAMCAT GUI or it is possible to extract the vector results in a separate file directly from command line.
java -cp seamcat.jar org.seamcat.CommandLine myWorkspaceResults.swr > myVectorResults.txt |
|---|
It opens Vector selection. Running the above code will generate a new file in .txt format as shown below.
It is possible to concatenate results in output result file with >> .
java -cp seamcat.jar org.seamcat.CommandLine myWorkspaceResults.swr >> myVectorResults.txt |
|---|
For automated process user can select vector to put in file like shown below
java -cp SEAMCAT_COMMANDLINE_5.4.2.jar org.seamcat.CommandLine Files\Workspace26.swr vector=all> Results26.xls java -cp SEAMCAT_COMMANDLINE_5.4.2.jar org.seamcat.CommandLine Files\Workspace26.swr vector=3> Results26.xls |
|---|
The vector results will contain the following vectors: the number of events, iRSSunwanted, iRSSblocking, the dRSS vector, the iRSSunwanted+blocking. and results from EPP-s.
Query on swr results (will work from v.5.5.1 ALPHA 2 and versions after)
The query string can be any string in the format described here: https://www.w3.org/TR/xpath-10/
java -cp seamcat-application-5.5.1-loctime-1.jar org.seamcat.CommandLine "WS_Simple_7_eEPP.swr" query="//Single[contains(@name, 'FDP')]" > FDresult.txt java -cp seamcat-application-5.5.1-loctime-1.jar org.seamcat.CommandLine "WS_Simple_7_eEPP.swr" query="//Single[contains(@name, 'C / I [unwanted]')]" >> FDresult.txt java -cp seamcat-application-5.5.1-loctime-1.jar org.seamcat.CommandLine "WS_Simple_7_eEPP.swr" query="//Single[@name='FDP']" >> FDresult.txt java -cp seamcat-application-5.5.1-loctime-1.jar org.seamcat.CommandLine "WS_Simple_7_eEPP.swr" query="//Single[@name='FDP']" filter=value >> FDresult.txt java -cp seamcat-application-5.5.1-loctime-1.jar org.seamcat.CommandLine "WS_Simple_7_eEPP.swr" query="//Single[contains(@name, 'FDP')]" filter=value >> FDresult.txt |
|---|
- extracts all Single items containing FDP in name
group="Fractional Degradation of Performance", name="FDP", type="double", unit="%", value="44.41316251798719"
group="Fractional Degradation of Performance", name="FDP - Long Term", type="double", unit="%", value="31.86399735657708"
group="Fractional Degradation of Performance", name="FDP - Short Term", type="double", unit="%", value="12.549165161410137"
...
You can also use some command like cut to clean-up the data you want. For instance, in Linux (Unix) environment, you can use cut command. For example, if you are only interested in the “number of events” and “iRSSunwnated”, you should use the following command:
cut -d$'\t' -f1,2 myVectorResults.txt > newFile.txt |
|---|
In Windows environment you can use command:
FOR /F "tokens=2-3 delims= " %i in (myVectorResults.txt) do @echo %i %j %k |
|---|