Offline BUFR to IODA Converter

Dependencies:

Colons can be used to align columns.

Dependencies
JEDI
IODACONV
bufr2ioda.x
yaml_template

---

gmao-utils

NASA/GMAO. Tools for working with data files in both BUFR and IODA (JEDI) format.

Directory Structure (skeleton)

Pre-Installation

Suggest that you first locate the following and copy their respective paths to a txt file or anywhere you can easily access it for copy and paste later on:

1. The script you use to load JEDI and/or Swell if you have one. If you don't have one disregard this - you will create one during the installation process.
2. Paths to the files you wish to convert - you will need this for copying the data files into the OBI/Demo/data/ folder.
3. Path to your jedi_bundle/build/bin - if you have a Swell Experiments folder you may be able to use the path `{Swell Experiments}/

Installation and Environment Setup

In order to run the Ioda Converter, bufr2ioda.x, you will need

1. Clone the gmao-utils repo.

$ git clone https://github.com/cohen-seth/gmao-utils.git

2. Next, open and edit config file:

$
$

1. Make a new working directory
2. Load Jedi - either directly or through Swell
3. Find your jedi_bundle/build directory
4. Add jedi_bundle/build/bin/bufr2ioda.x to your PATH
5. Copy the corresponding yaml files for the observation type that you want to convert from jedi_bundle/build/iodaconv/test/testinput into your working directory
6. Within the yaml file you copied in step 5, you will need to change the obsdatain path to the path to the bufr file you want to conver and obsdataout to the desired path and name of the resulting ioda file.
7. To run the conversion run bufr2ioda.x [path of the yaml file you just made]

Function examples

bufr2ioda.x

1. Locate the

$ bufr2ioda.x [PATH OF YAML TEMPLATE]

bufr2ioda_offline_driver.py

$ python3 bufr2ioda_offline_driver.py [PATH TO BUFR FILE(S)] [PATH OF IODA FILE(S)] [PATH OF YAML TEMPLATE]

5. OPTIONAL Then, you may want to inspect and verify LoadJedi.sh. You should NOT need to edit this file; HOWEVER, you may need to in the future if there is a more recent build of JEDI/IODA. The everything in this file must point to a current build of the JEDI IODA CONVERTERS.