User can run SEAMCAT from Command Line which helps if you want just to run simulation and get the results. This feature is useful to run SEAMCAT simulation on number of already prepared workspaces, or if resources of the computer is an issue. In Command Line SEAMCAT just run the simulation on already prepared workspace and Graphical User Interface is not launched. Find below some tips for using SEAMCAT in a command line environment.
A command line launch of SEAMCAT (i.e. without GUI) is possible using the same seamcat.jar file that you have downloaded. From the command line with a workspace file called "myWorkspace.sws" the following command will It will launch the workspace and save the results in myWorkspace.swr by default.
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 |
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.
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.
Afterwards you can 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 |
|---|