Pre-release

This release is a pre-release and may not be stable for production use.

VSWMC Command-Line Interface

Install with pip:

pip install --upgrade vswmc-cli

This will install a vswmc command on your system. The vswmc command uses an S2P OAuth access token for authentication. Obtain the token outside the CLI, for example with the OAuth 2.0 Client Credentials flow described in the SSO migration guide, then provide it with one of:

VSWMC_ACCESS_TOKEN

Read the access token from the environment.

--token TOKEN

Read the access token from the command line.

--token-file FILE

Read the access token from a file.

Example token request:

curl \
  -d 'client_id=<M2M_CLIENT_ID>' \
  -d 'client_secret=<M2M_CLIENT_SECRET>' \
  -d 'grant_type=client_credentials' \
  -d 'scope=<VSWMC_RESOURCE_SERVER_CLIENT_ID>' \
  'https://sso.s2p.esa.int/realms/swe/protocol/openid-connect/token'

Example CLI usage:

export VSWMC_ACCESS_TOKEN=<ACCESS_TOKEN>
vswmc simulations list

List available simulations

vswmc simulations list

This shows the parameters that a run requires.

Start a run

vswmc run [--param-file PARAM_FILE] [--param PARAM=VALUE ...] -- SIMULATION

This command returns the ID of the new run via stdout. You can use this ID to fetch the log or fetch result files.

OPTIONS

--param-file PARAM_FILE: Read parameters from a file.
--param PARAM=VALUE ...: Set parameters.

Each simulation supports different parameters. To know what parameters you need for a particular simulation, run:

vswmc simulations describe SIMULATION

List runs

vswmc ps [--simulation SIMULATION] [-a, --all]

OPTIONS

--simulation SIMULATION: Filter on simulation.
-a, --all: List all runs (default shows only ongoing)

Copy a result file to disk

vswmc cp SRC DST

Downloads a remote result file to local disk. The source should be specified in the format RUN:FILE. The DST argument can be a local file or directory.

Fetch the logs of a run

vswmc logs RUN

List the results of a run

vswmc ls [-l] RUN

OPTIONS

-l: Print long listing

Save all results of a run

vswmc save RUN

Saves all result files of a run. The results of each individual task in this run are compressed and saved into a zip archive named after the model for that task.

Stop one or more runs

vswmc stop RUN ...

Remove one or more runs

vswmc rm RUN ...

Create a product

vswmc products create [--metadata-file FILE] [--metadata PARAM=VALUE ...] [--attach FILE ...] -- PRODUCT_TYPE

OPTIONS

--param-file PARAM_FILE: Read parameters from a file.
--param PARAM=VALUE ...: Set parameters.
--attach FILE ...: Attach product files

EXAMPLE

vswmc products create --metadata test=123 --attach ../testdata/solar_wind_boundary.dat -- MHD0.1-1

Returns the ID of the created product.

Start a run using a product as input

vswmc run --param corona=6273ce7678eeb43c60d2eb8f \
          --param grid=test_light \
          --param cmes=examples/resources/cme_list.dat \
          -- euhforia-heliosphere-standalone

The corona parameter expects a product identifier.

Metadata

Release files for vswmc-cli 2.2.3.dev426

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vswmc-cli 2.2.3.dev426
File	Size	Uploaded
vswmc_cli-2.2.3.dev426.tar.gz	15.4 kB	Jun 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vswmc-cli 2.2.3.dev426
File	Interpreter	ABI	Platform	Reset
vswmc_cli-2.2.3.dev426-py2.py3-none-any.whl 19.5 kB Jun 20, 2026	Python 2, Python 3	none	any	Details

Total release size: 34.9 kB

Release files / vswmc_cli-2.2.3.dev426.tar.gz

Download URL	vswmc_cli-2.2.3.dev426.tar.gz
Size	15.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`a6dd997aaa3ddd6ebe209bf74228619fc1594687c2a1a9db5ac9a13fd869946a`
BLAKE2b-256 checksum How to use checksums	`99f75004520da39bea121c311c0067fc80bd92a7078888b71a141f6f1b846201`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.20`

Release files / vswmc_cli-2.2.3.dev426-py2.py3-none-any.whl

Download URL	vswmc_cli-2.2.3.dev426-py2.py3-none-any.whl
Size	19.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`5c96acfc15f37e132db09b19082ec075b6117f5131a75a019f96ed4e8bf18869`
BLAKE2b-256 checksum How to use checksums	`000897e8f4959be507311b2b92cb1f68f282792c950c95a20ceedfbffc2a2775`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.20`