2.8 Running from the command line

 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 

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 
Revision #2
Created 2026-04-14 08:52:51 UTC by ECO TECH
Updated 2026-04-14 08:54:45 UTC by ECO TECH