# Step by step guide :::{note} This guide assumes that _auto-icon_ is already fully set up. You can follow the instructions on the respective [setup page](/Setup/Setting-up-auto-icon.md) to do so. ::: It is an overview of the steps that have to be done. If you want to transform a runscript into an _auto-icon_ configuration, you can also follow the instructions here and for the configuration steps (5. and 7.), refer to the detailed documentation on [how to transform a runscript into an auto-icon configuration](/Introductory-guides/Transform-a-runscript-into-an-auto-icon-configuration.md). ## 1. Add a new experiment Run the following command and substitute the placeholders `` and ``. `` is the HPC system to be used. Currently predefined are 'LEVANTE' and 'HOREKA'. `` is the type of ICON use case to be used. It can be `art` (for a basic atmospheric run with or without ART), `seamless` (for a run coupled to JSBACH and/or the ocean) or one of `real-from-ideal`, `real-from-dwd-ana` or `build-only`. For the latter three, please refer to the [Quick start guide](/Introductory-guides/Quick-start.md). ``` $ autosubmit expid \ -min \ -repo "https://gitlab.dkrz.de/auto-icon/auto-icon.git" \ -conf "conf/.yml" \ -b main \ -H \ -d "My perfect but short experiment description." Autosubmit is running with 4.0.84 The new experiment "a00j" has been registered. Generating folder structure... Experiment folder: /pool/experiments/a00j Generating config files... Experiment a00j created ``` ## 2. Go to the experiment directory Change to the experiment directory (e.g. `/pool/experiments/a00j`). All paths from now on will be relative to this directory. Also remember the "expid" of the project (e.g. `a00j`). It has proven useful to write it down for later reference. ## 3. Initialize your experiment This will clone the *auto-icon* project in your experiment folder (in `proj/git_project`). ```bash autosubmit create -np ``` Further, the command creates the first workflow. Lateron it will be used again to create the final workflow. ## 4. Initialize the _auto-icon_ project Choose a name for your experiment (without spaces, ideally it is short but descriptive). If you want to run one of the templates, you should just use the name of the template. For complete beginners with ICON, we recommend `NWP_LIFETIME` (chemistry) or `DUST_RAD` (dust aerosol) standard cases of ICON-ART. There are several different [templates](/Userguide/Templates.md) among which are also some of the ICON-ART standard cases (with input data publicly available). Further, for the following cases, input data is available additionally: - DUST_AERODYN: global dust simulation with multiple chunks. ([input data](https://bwsyncandshare.kit.edu/s/Lf6tyZzK9JzbjAr)) - ICON_ART_LES: basic ICON-ART-LES simulation with diverse soil data. ([input data](https://bwsyncandshare.kit.edu/s/HZKbTHfz4iPYexM)) To run the templates, download the input data, extract it (`tar -zxvf `) and move it to wherever you want your input directory to be (see [below](#6-modify-the-configuration) for specification of input directories). Now run the following command: ```bash ./proj/git_project/auto-icon-init -e [-t