The following GCM, NWP models and reanalyses are supported:
Note: The ERA-Interim reanalysis is not supported due to the required fields (mass fraction of cloud liquid water and ice in air) not available in the dataset.
Below is a description of the model output supported by the ALCF. You might have to modify the code for reading the model output depending on the exact format of the model output, such as variable names and how they are split among the output files.
The ALCF is compatible with the NetCDF AMPS output. You can find the AMPS archive on the Earth System Grid (ESG) website. The following files conver 24 hours of model output:
wrfout_dxx_YYYYmmdd00_f003.nc wrfout_dxx_YYYYmmdd00_f006.nc wrfout_dxx_YYYYmmdd00_f009.nc wrfout_dxx_YYYYmmdd00_f012.nc wrfout_dxx_YYYYmmdd12_f003.nc wrfout_dxx_YYYYmmdd12_f006.nc wrfout_dxx_YYYYmmdd12_f009.nc wrfout_dxx_YYYYmmdd12_f012.nc
xx is the AMPS grid,
YYYYmmdd is the year (
YYYY), month (
mm) and day (
files are not suitable for use with the ALCF as they do not contain all required
ERA5 reanalysis data can be downloaded from Copernicus. Download the following datasets:
ERA5 hourly data on pressure levels from 1979 to present
- Product type:
Specific cloud ice water content,
Fraction of cloud cover,
Specific cloud liquid water content,
- Pressure level: all
- Time: all (preferred)
ERA5 hourly data on single levels from 1979 to present
- Product type:
- Time: the same as above
Save the pressure-level files in a directory named
plev and the surface-level
files in a directory named
surf. Pass the path to the parent directory
alcf model or
alcf auto model.
ICON is a weather and climate model developed by the German Weather Service and the Max Planck Institute for Meteorology.
The following fields on model levels are required:
cli(specific cloud ice content)
clw(specific cloud water content)
The following fields on the surface level are required:
ps(surface air pressure)
The files should be all contained in the input directory. The vertical grid
file should be placed in the input directory with a name
vgrid.nc. No other
files should be present in the input directory. The time frequency of the model
level and surface level files does not have to be the same, in which case a
subset of intersecting time steps is processed. The horizontal grid file is not
required. The input files are expected the be on the unstructured grid (a set
The JRA-55 reanalysis data can be downloaded from the JRA-55 project website. The following fields are required by the ALCF:
anl_p125/anl_p125_hgt(Geopotential height @ Isobaric Surface)
anl_p125/anl_p125_tmp(Temperature @ Isobaric Surface)
anl_surf125(Surface analysis fields)
fcst_p125/fcst_p125_ciwc(Cloud ice @ Isobaric Surface)
fcst_p125/fcst_p125_clwc(Cloud liquid water @ Isobaric Surface)
fcst_p125/fcst_p125_tcdc(Total cloud cover @ Isobaric Surface)
Download files for the period of interest all into the same directory. The JRA-55 GRIB files have to be converted to NetCDF before they can be used with the ALCF. Use grib_to_netcdf to convert the data. All data files should reside in the same directory.
MERRA-2 reanalysis files can be found via the NASA EarthData portal. Description of the MERRA-2 products can be found in the MERRA-2: File Specification document. The model-level products are recommended due to their higher resolution. Only the “Assimilated Meteorological Fields” contain the required variables. The recommended product is the “inst3_3d_asm_Nv (M2I3NVASM): Assimilated Meteorological Fields”, i.e. the 3-hourly instantaneous 3D assimilated fields on model levels. You can find the product files by searching for “M2I3NVASM” on NASA EarthData, or directly on the NASA EOSDIS FTP server.
New Zealand Convective Scale Model (NZCSM) is a NWP model based on the UK Met Office Unified Model. The following model output variables are needed to run the lidar simulator:
New Zealand Earth System Model output is a model based on HadGEM3. The model output variables needed are:
The NetCDF output (configuration option
l_netcdf) of the UK Met Office
Unified Model (UM) is supported. The following variables are required:
DALLTH_zsea_theta(Height above mean sea level)
STASH_m01s00i265(AREA CLOUD FRACTION IN EACH LAYER)
STASH_m01s00i408(PRESSURE AT THETA LEVELS AFTER TS)
STASH_m01s00i409(SURFACE PRESSURE AFTER TIMESTEP)
STASH_m01s16i004(TEMPERATURE ON THETA LEVELS)
ALCF <= 1.0.0-beta.2:
STASH_m01s04i205(CLOUD LIQUID WATER AFTER LS PRECIP)
STASH_m01s04i206(CLOUD ICE CONTENT AFTER LS PRECIP)
ALCF > 1.0.0-beta.2:
STASH_m01s00i254(QCL AFTER TIMESTEP)
STASH_m01s00i012(QCF AFTER TIMESTEP)
The variables should be provided on all theta levels and as high temporal sampling as possible (instantaneous). All variables should be dumped together to the same NetCDF file, split by time into arbitrary number of files.
In addition, a file containing model orography is required. Convert the
qrparam.orog file distributed with the UM to NetCDF with iris:
python -c "import iris;c=iris.load('qrparm.orog');iris.save(c,'qrparm.orog.nc')"
qrparm.orog.nc in the same directory as the model output files.