Your first experiment

Create your own experiment

Create an Autosubmit experiment using minimal configurations to run a test experiment in marenostrum5.

To run your first experiment, you need to have an experiment ID (autosubmit expid) for you this can be done by:

autosubmit expid \
  --description "My first experiment" \
  --HPC MareNostrum5 \
  --minimal_configuration \
  --git_as_conf conf/bootstrap/ \
  --git_repo https://earth.bsc.es/gitlab/digital-twins/de_340-2/workflow \
  --git_branch <latest TAG (see below)>

Command Options
Key	Options	Notes
DESCRIPTION	any	Add some useful information
PLATFORM	marenostrum5, lumi	More platforms can be added in the future
TAG	use latest tag	Latest tested tag

Note

You must change the keys between < > !

You will receive the following message: Experiment <expid> created, where <expid> is the identifier of your experiment. A directory will be created for your experiment at: /appl/AS/AUTOSUBMIT_DATA/<expid>.

Basic instructions to execute the workflow with Autosubmit can be found in How to run. The rest of the documentation is available in the same Wiki.

Start the interactive command line to setup the main characteristics of your experiment: write(models), read(apps,simless) or streaming(end-to-end).

# type anywhere in the virtual machine
autosubmit create <expid>

Note

You are asked to introduce the credentials to the remote repositories, therefore you must have access to it to proceed.

You will be further asked to select the type of workflow you want to run:

Choose a workflow:
1. model
2. end_to_end
3. app
4. simless
Enter your choice (1/2/3/4):

Depending on the option that you select you will be further asked for details on the simulation you want to run, such as what model or applications you want to run and for what period.

Note

You have now the option to edit the document in vim. You can do it by typing ‘i’, edit it and save it by typing ‘:wq’. If you have any doubts when editing the main configuration file, read carefully the keys description in docs/source/keys_main.rst.

Note

The supported options for the current tutorial are: app, end-to-end (ifs-nemo), and model (ifs-nemo).

You will be popped up with a pdf of the structure o fthe workflow that you just have chosen. In this moment the experiment is as well visible in the Autosubmit GUI.

After your experiment is defined and you are fine with what you see in the image or in the GUI, close the PDF to continue. You can then execute autosubmit run $expid to run your experiment. If you want to have your experiment in the background (that is, in a way you can close your terminal and get a coffee in the meantime) you can use the nohup (no hang up) command:

nohup autosubmit run $expid &