https://github.com/doi-usgs/volcano-ash3d-metreader
https://github.com/doi-usgs/volcano-ash3d-metreader
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/doi-usgs/volcano-ash3d-metreader
- Owner: DOI-USGS
- License: other
- Created: 2017-10-03T12:34:51.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-08T02:32:58.000Z (3 months ago)
- Last Synced: 2025-03-08T03:23:32.317Z (3 months ago)
- Language: Fortran
- Size: 10.1 MB
- Stars: 1
- Watchers: 6
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
MetReader
==========
MetReader is a library written in Fortran 90 that provides an interface to
numerical weather prediction (NWP) data, or other forms of meteorological
data, such as radiosonde or other 1-d data.
This library was originally written as a component of the USGS volcanic ash
transport and dispersion model, Ash3d. However, since it is useful for
other programs in addition to Ash3d, this interface to NWP files is provided
as a separate repository that can either be compiled as a library or simply
compiled directly with other source code.
NWP data are generally made available by agencies (NCEP, NOAA, NASA, ECMWF, etc.)
in a variety of formats (NetCDF, GRIB, ASCII); each product having
its own data structure, naming convention, units, etc. This library
isolates the calling program from the peculiarities of interfacing with
a particular NWP product. Data can be returned to the calling program on
the native grid of the NWP product, or on any grid needed by the calling
program. Projection and interpolation of NWP data to the required grid, along
with any rotation of velocity vectors to grid-relative, is calculated internally by
MetReader.
For details on usage, please see the [User's Guide](doc/MetReader_manual.pdf).
The various tools, such as `MetRegrid` or `MetTraj_F` can provide useful
examples on how to include MetReader into a program.
This library requires two additional libraries made available on GitHub and USGS GitLab:
- [HoursSince](https://github.com/DOI-USGS/volcano-ash3d-hourssince)
- [projection](https://github.com/DOI-USGS/volcano-ash3d-projection)
Additionally, the default makefile will build MetReader with both NetCDF and GRIB2
enabled. If either of these libraries are unavailable on your system, you can
deactivate those options by setting the corresponding flags to 'F' in the makefile.
To compile as a library, simply type:
`make all`
This will build the requested components of the library. If GRIB2 is enabled,
it is recommended to also build the GRIB2 indexer:
`make gen_GRIB2_index`
This is a tool that generates an index file of the GRIB records which speeds
access time to individual records substantially.
To test the build, you can run:
`make check`
This will run several of the tools with example control files using two
sets of wind files: a network of radiosonde files, and the NCEP 50-year
Reanalysis data (if available).
To install the library, module files and tools, edit the `INSTALLDIR` variable of
the makefile (the default is `/opt/USGS`) and type:
`make install`
This will also install scripts that can be used to download a variety of NWP products
including the NCEP 2.5-degree Reanalysis files and the GFS, NAM, ECMWF forecasts.
Some of these might require license agreements.
You will need to have write permission in `${INSTALLDIR}` or install as root.
Authors
-------
Hans F. Schwaiger
Larry G. Mastin
Roger P. Denlinger