Variables reference

Autosubmit uses a variable substitution system to facilitate the development of the templates. This variables can be used on the template in the form %VARIABLE_NAME%.

Job variables

This variables are relatives to the current job.

  • TASKTYPE: type of the job, as given on job configuration file.
  • JOBNAME: current job full name.
  • FAIL_COUNT: number of failed attempts to run this job.
  • SDATE: current startdate.
  • MEMBER: current member.
  • CHUNK: current chunk.
  • SPLIT: current split.
  • DELAY: current delay.
  • DAY_BEFORE: day before the startdate
  • Chunk_End_IN_DAYS: chunk’s length in days
  • Chunk_START_DATE: chunk’s start date
  • Chunk_START_YEAR: chunk’s start year
  • Chunk_START_MONTH: chunk’s start month
  • Chunk_START_DAY: chunk’s start day
  • Chunk_START_HOUR: chunk’s start hout
  • Chunk_END_DATE: chunk’s end date
  • Chunk_END_YEAR: chunk’s end year
  • Chunk_END_MONTH: chunk’s end month
  • Chunk_END_DAY: chunk’s end day
  • Chunk_END_HOUR: chunk’s end hour
  • PREV: days since startdate at the chunk’s start
  • Chunk_FIRST: True if the current chunk is the first, false otherwise.
  • Chunk_LAST: True if the current chunk is the last, false otherwise.
  • NUMPROC: Number of processors that the job will use.
  • NUMTHREADS: Number of threads that the job will use.
  • NUMTASK: Number of tasks that the job will use.
  • WALLCLOCK: Number of processors that the job will use.
  • SCRATCH_FREE_SPACE: Percentage of free space required on the scratch.
  • NOTIFY_ON: Determine the job statuses you want to be notified.
  • WRAPPER: Wrapper type, None if wrapper is not being used

Platform variables

This variables are relative to the platoforms defined on the jobs conf. A full set of the next variables are defined for each platform defined on the platforms configuration file, substituting {PLATFORM_NAME} for each platform’s name. Also, a suite of variables is defined for the current platform where {PLATFORM_NAME} is substituted by CURRENT.

  • {PLATFORM_NAME}_ARCH: Platform name
  • {PLATFORM_NAME}_HOST: Platform url
  • {PLATFORM_NAME}_USER: Platform user
  • {PLATFORM_NAME}_PROJ: Platform project
  • {PLATFORM_NAME}_BUDG: Platform budget
  • {PLATFORM_NAME}_RESERVATION: You can configure your reservation id for the given platform.
  • {PLATFORM_NAME}_EXCLUSIVITY: True if you want to request exclusivity nodes.
  • {PLATFORM_NAME}_TYPE: Platform scheduler type
  • {PLATFORM_NAME}_VERSION: Platform scheduler version
  • {PLATFORM_NAME}_SCRATCH_DIR: Platform’s scratch folder path
  • {PLATFORM_NAME}_ROOTDIR: Platform’s experiment folder path
  • {PLATFORM_NAME}_CUSTOM_DIRECTIVES: Platform’s custom directives for the resource manager.

Hint

The variables _USER, _PROJ and _BUDG has no value on the LOCAL platform.

Hint

Until now, the variables _RESERVATION and _EXCLUSIVITY are only available for MN.

It is also defined a suite of variables for the experiment’s default platform:

  • HPCARCH: Default HPC platform name
  • HPCHOST: Default HPC platform url
  • HPCUSER: Default HPC platform user
  • HPCPROJ: Default HPC platform project
  • HPCBUDG: Default HPC platform budget
  • HPCTYPE: Default HPC platform scheduler type
  • HPCVERSION: Default HPC platform scheduler version
  • SCRATCH_DIR: Default HPC platform scratch folder path
  • HPCROOTDIR: Default HPC platform experiment’s folder path

Project variables

  • NUMMEMBERS: number of members of the experiment
  • NUMCHUNKS: number of chunks of the experiment
  • CHUNKSIZE: size of each chunk
  • CHUNKSIZEUNIT: unit of the chuk size. Can be hour, day, month or year.
  • CALENDAR: calendar used for the experiment. Can be standard or noleap.
  • ROOTDIR: local path to experiment’s folder
  • PROJDIR: local path to experiment’s proj folder

Performance Metrics

Currently, these variables apply only to the report function of Autosubmit. See How to extract information about the experiment parameters.

  • SYPD: Simulated years per day.
  • ASYPD: Actual simulated years per day.
  • RSYPD: Raw simulated years per day.
  • CHSY: Core hours per simulated year.
  • JPSY: Joules per simulated year.
  • Parallelization: Number of cores requested for the simulation job.

For more information about these metrics please visit:

https://earth.bsc.es/gitlab/wuruchi/autosubmitreact/-/wikis/Performance-Metrics.