Skip to content

degauss-org/narr

Repository files navigation

narr

container build status

Using

If my_address_file_geocoded.csv is a file in the current working directory with coordinate columns named lat, lon, start_date, and end_date then the DeGAUSS command:

docker run --rm -v $PWD:/tmp ghcr.io/degauss-org/narr:0.4.0 my_address_file_geocoded.csv

will produce my_address_file_geocoded_narr_0.4.0_weather.csv with added columns:

  • air.2m: air temperature at 2m
  • rhum.2m: humidity at 2m

Optional Argument

Users can supply an optional argument to select which NARR variables are returned:

Argument Variables Returned Variable Definitions
weather (default) air.2m
rhum.2m
air temperature at 2m
humidity at 2m
wind uwnd.10m
vwnd.10m
U wind speed at 10m
V wind speed at 10m
atmosphere hpbl
vis
planetary boundary layer height
visibility
pratepres prate
pres.sfc
precipitation rate
surface pressure
none narr_cell NARR raster cell number

For example,

docker run --rm -v $PWD:/tmp ghcr.io/degauss-org/narr:0.4.0 my_address_file_geocoded.csv wind 

will return uwnd.10m and vwnd.10m.

This argument can also be used to only return the narr_cell, which is the NARR raster cell number, to be used for later NARR data lookups:

docker run --rm -v $PWD:/tmp ghcr.io/degauss-org/narr:0.4.0 my_address_file_geocoded.csv none

Docker RAM requirements

If this container errors unexpectedly, you may need to allocate more RAM to Docker. Please see the troubleshooting guide for more information.

Geomarker Methods

This container was built using the addNarrData package.

Geomarker Data

  • Daily weather data was downloaded from NARR.
  • NARR data is stored as fst files at s3://geomarker/narr/narr_chunk_fst/.
  • Detailed information for how data was converted to chunk files can be found here.

DeGAUSS Details

For detailed documentation on DeGAUSS, including general usage and installation, please see the DeGAUSS homepage.