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 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

Build Requirements

This module requires the NetCDF C++ library.

Acknowledgements

This module was developed within the EU-funded project Open Forecast