# ReadWrfChem read WRF-Chem (Weather Research and Forecasting model coupled to Chemistry) data files ## Purpose This module can be used to import data from NetCDF files generated by [WRF-Chem](https://ruc.noaa.gov/wrf/wrf-chem/) simulations. ## Data Preparation Files must be in NetCDF format (type classic or 64-bit offset). The underlying data structure is assumed to be a structured grid. For dynamic data, data for each timestep must be present in a separate file. ## Ports ReadWrfChem grid_out grid (grid_out) data_out0 scalar data (data_out0) data_out1 scalar data (data_out1) data_out2 scalar data (data_out2) data_out_U scalar data (data_out_U) data_out_V scalar data (data_out_V) data_out_W scalar data (data_out_W) ## Parameters |name|description|type| |-|-|-| |first_step|first timestep to read|Int| |last_step|last timestep to read (-1: last)|Int| |step_increment|number of steps to increment|Int| |first_rank|rank for first partition of first timestep|Int| |file_dir|NC files directory|String| |num_partitions_lat|number of partitions in lateral|Int| |num_partitions_ver|number of partitions in vertical|Int| |var_dim|Dimension of variables (2D, 3D, other)|String| |true_height|Use real ground topology ((NONE))|String| |GridX|grid Sout-North axis ((NONE))|String| |GridY|grid East_West axis ((NONE))|String| |pert_gp|perturbation geopotential ((NONE))|String| |base_gp|base-state geopotential ((NONE))|String| |GridZ|grid Bottom-Top axis ((NONE))|String| |Variable0|Variable0 ((NONE))|String| |Variable1|Variable1 ((NONE))|String| |Variable2|Variable2 ((NONE))|String| |U|U ((NONE))|String| |V|V ((NONE))|String| |W|W ((NONE))|String| |distribute_time|distribute timesteps across MPI ranks|Int| ### Required parameters File must provide at least the following variables: - **file_dir** : Path to directory containing NetCDF file(s). - **GridX**, **GridY**: lateral coordinates (typically latitude and longitude) of each vertex Also either of the following is necessary: - **GridZ** : elevation (in meters) of vertex - **pert gp** and **base gp**: geopotential to be used for computation of altitude of vertices ### Important Optional Parameters The remaining parameters might be changed/selected as needed: - **var dim**: choose dimension of variables - **Variable0-2**: scalar data (given on the grids vertices) ## Usage Examples ![](../../../module/read/ReadWrfChem/Example_ReadWrfChem.png) ## Related Modules ### Often Used With ReadWrfChem is typically followed by: - MapDrape ## Build Requirements This module requires the [NetCDF C++](https://www.unidata.ucar.edu/software/netcdf/) library. ## Acknowledgements This module was developed within the EU-funded project [Open Forecast](https://open-forecast.eu)