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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vswmc_cli-2.2.3.tar.gz (15.4 kB view details)

Uploaded Jul 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vswmc_cli-2.2.3-py2.py3-none-any.whl (19.4 kB view details)

Uploaded Jul 3, 2026 Python 2Python 3

File details

Details for the file vswmc_cli-2.2.3.tar.gz.

File metadata

Download URL: vswmc_cli-2.2.3.tar.gz
Upload date: Jul 3, 2026
Size: 15.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.10.20

File hashes

Hashes for vswmc_cli-2.2.3.tar.gz
Algorithm	Hash digest
SHA256	`f67d086e09d42cdb7772b7b0a93a17fb4036e2f6a522fd0815551a515dc9db5b`
MD5	`b06a043769d61ff39b3c9459940ce4bc`
BLAKE2b-256	`168a2216c272b8b406f764114f16dbda5e3743764fcbd4d20d167c5f875fc6f2`

See more details on using hashes here.

File details

Details for the file vswmc_cli-2.2.3-py2.py3-none-any.whl.

File metadata

Download URL: vswmc_cli-2.2.3-py2.py3-none-any.whl
Upload date: Jul 3, 2026
Size: 19.4 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.10.20

File hashes

Hashes for vswmc_cli-2.2.3-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`5791e0d74e14243b0e702b6c73d46152fd4621348bfb23f5d2fdfe3da67e3ce3`
MD5	`ca926bf0101c7873f0aea559fbd956db`
BLAKE2b-256	`30537d1cd5f686fb7eebd8e2e21e72ef0b1eb737a4a25269ce45ce4e0054fa15`