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: SRTM_1as_bil_v3 SRTM_1as_bil_v2 SRTM_3as_bil_v2 GeoTIFF	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, iRSS_unwanted, iRSS_blocking, the dRSS vector, the iRSS_{unwanted+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"

extracts all Single items containing C/I in name
group="Interference Compatibility Calculations (C > receiver sensitivity)", name="C / I [unwanted]", type="double", unit="%", value="35.35756154747949"

extracts all Single item where name is =FDP
group="Fractional Degradation of Performance", name="FDP", type="double", unit="%", value="44.41316251798719"

extracts all Single item where name is =FDP and get only values
44.41316251798719

extracts all Single items containing FDP in name and get only values
44.41316251798719
31.86399735657708
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 “iRSS_unwnated”, 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

Browser not supported