Difference between revisions of "Downloading data from WashU"

From Geos-chem
Jump to: navigation, search
(→‎Examples)
(→‎Examples)
Line 180: Line 180:
 
=== Examples ===
 
=== Examples ===
  
−
1. Download an entire directory (and its subdirectories) from Compute Canada to your current folder:
+
1. Download remote directory <tt>geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME</tt> to <tt>./ExtData/DIRECTORY_NAME</tt>.
  
−
  <nowiki>wget -r -np -nH -N -R "*.html" "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"</nowiki>
+
  wget -r -np -nH -N -R "*.html" <nowiki>"http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"</nowiki>
  
  
−
2. Similar to Example 1 above, but wll download the directory <tt>geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME to <tt><span style=
+
2. Similar to Example 1 above, but will download remote directory <tt>geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME</tt> to <tt>./DIRECTORY_NAME</tt>.  We have used <span style="color:red"><tt>--cut-dirs=1</tt></span> to trim one level off the downloaded directory.
−
color=red">/home/data</span>/ExtData/DIRECTORY_NAME</tt>:
+
 +
wget -r -np -nH -N -R "*.html" <span style="color:red">--cut-dirs=1</span> <nowiki>"http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME/"</nowiki>
  
−
<nowiki>wget -r -np -nH -N -R "*.html" <span style="color:red">-P /home/data</span> "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"</nowiki>
 
  
 +
3. Similar to Example 1 above, but wll download the directory <tt>geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME</tt> to <tt><span style="color:red">/pub/gcgrid/data</span>/ExtData/DIRECTORY_NAME</tt>:
  
−
3. Trim the name of the downloaded directory (i.e., so it downloads as <tt>DIRECTORY_NAME</tt>, not <tt>pub/geos-chem/data/DIRECTORY_NAME</tt>), then use the <tt>--cut-dirs</tt> option:
+
  wget -r -np -nH -N -R "*.html" <span style="color:red">-P /pub/gcgrid/data</span> <nowiki>"http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"</nowiki>
−
   
+
−
<nowiki>wget -r -np -nH -N -R "*.html" --cut-dirs=X "http://geoschemdata.computecanada.ca/DIRECTORY_NAME/"</nowiki>
+
−
 
+
−
where <tt>X</tt> is the number of directories to trim.
+

Revision as of 17:33, 12 December 2019

Compute Canada directory structure

The GEOS-Chem shared data directories may be downloaded from the Compute Canada server: 

http://geoschemdata.computecanada.ca

which has the following directory structure:

Directory Description
ExtData/ Root data directory containing all meteorlogy fields, emissions data, and chemistry input data.
ExtData/CHEM_INPUTS/ Contains non-emissions data for GEOS-Chem chemistry modules
ExtData/HEMCO/ Contains emissions data for the HEMCO emissions component
ExtData/GEOSCHEM_RESTARTS/ Contains sample restart files uses to initialize GEOS-Chem simulations.
0.25° x 0.3125° Data Directories Description
ExtData/GEOS_0.25x0.3125/GEOS_FP/YYYY/MM/ 0.25° x 0.3125° GEOS-FP global met fields
ExtData/GEOS_0.25x0.3125_AS/GEOS_FP/YYYY/MM/ 0.25° x 0.3125° GEOS-FP met fields cropped to the Asia domain
ExtData/GEOS_0.25x0.3125_CH/GEOS_FP/YYYY/MM/ 0.25° x 0.3125° GEOS-FP met fields cropped to the China domain
ExtData/GEOS_0.25x0.3125_EU/GEOS_FP/YYYY/MM/ 0.25° x 0.3125° GEOS-FP met fields cropped to the Europe domain
ExtData/GEOS_0.25x0.3125_NA/GEOS_FP/YYYY/MM/ 0.25° x 0.3125° GEOS-FP met fields cropped to the North America domain
0.5° x 0.625° Data Directories Description
ExtData/GEOS_0.5x0.625/MERRA2/YYYY/MM/ 0.5° x 0.625° MERRA-2 global met fields
ExtData/GEOS_0.5x0.625_AS/MERRA2/YYYY/MM/ 0.5° x 0.625° MERRA-2 met fields cropped to the Asia domain
ExtData/GEOS_0.5x0.625_CH/MERRA2/YYYY/MM/ 0.5° x 0.625° MERRA-2 met fields cropped to the China domain
ExtData/GEOS_0.5x0.625_EY/MERRA2/YYYY/MM/ 0.5° x 0.625° MERRA-2 met fields cropped to the Europe domain
ExtData/GEOS_0.5x0.625_NA/MERRA2/YYYY/MM/ 0.5° x 0.625° MERRA-2 met fields cropped to the North America domain
2° x 2.5° Data Directories Description
ExtData/GEOS_2x2.5/GEOS_FP/YYYY/MM 2° x 2.5° GEOS-FP global met fields
ExtData/GEOS_2x2.5/MERRA2/YYYY/MM 2° x 2.5° MERRA-2 global met fields
4° x 5° Data Directories Description
ExtData/GEOS_4x5/GEOS_FP/YYYY/MM/ 4° x 5° GEOS-FP global met fields
ExtData/GEOS_4x5/MERRA2/YYYY/MM/ 4° x 5° MERRA-2 global met fields

--Bob Yantosca (talk) 19:21, 11 December 2019 (UTC)

GEOS-FP and MERRA-2 constant data files

If you are downloading the GEOS-FP or MERRA-2 met data, then please note that you must also download the "CN" (constant) data files for each horizontal grid that you are using.

For GEOS-FP these are timestamped for 2011/01/01 and are found in these data directories:

  • ExtData/GEOS_0.25x0.3125/GEOS_FP/2011/01/GEOSFP.20110101.CN.025x03125.nc
  • ExtData/GEOS_0.25x0.3125_AS/GEOS_FP/2011/01/GEOSFP.20110101.CN.025x03125.AS.nc
  • ExtData/GEOS_0.25x0.3125_CH/GEOS_FP/2011/01/GEOSFP.20110101.CN.025x03125.CH.nc
  • ExtData/GEOS_0.25x0.3125_EU/GEOS_FP/2011/01/GEOSFP.20110101.CN.025x03125.EU.nc
  • ExtData/GEOS_0.25x0.3125_NA/GEOS_FP/2011/01/GEOSFP.20110101.CN.025x03125.NA.nc
  • ExtData/GEOS_2x2.5/GEOS_FP/2011/01/GEOSFP.20110101.CN.2x25.nc
  • ExtData/GEOS_4x5/GEOS_FP/2011/01/GEOSFP.20110101.CN.4x5.nc

For MERRA-2 these are timestamped for 2015/01/01 and are found in these data directories :

  • ExtData/GEOS_0.5x0.625/MERRA2/2015/01/MERRA2.20150101.CN.05x0625.nc4
  • ExtData/GEOS_0.5x0.625_AS/MERRA2/2015/01/MERRA2.20150101.CN.05x0625.AS.nc4
  • ExtData/GEOS_0.5x0.625_CH/MERRA2/2015/01/MERRA2.20150101.CN.05x0625.CH.nc4
  • ExtData/GEOS_0.5x0.625_EU/MERRA2/2015/01/MERRA2.20150101.CN.05x0625.EU.nc4
  • ExtData/GEOS_0.5x0.625_NA/MERRA2/2015/01/MERRA2.20150101.CN.05x0625.NA.nc4
  • ExtData/GEOS_2x2.5/MERRA2/2015/01/MERRA2.20150101.CN.2x25.nc4
  • ExtData/GEOS_4x5/MERRA2/2015/01/MERRA2.20150101.CN.4x5.nc4

Additional notes:

  • Prior to downloading GEOS-FP data, please be aware of caveats regarding use of GEOS-FP. See the GEOS-FP wiki page for more information.

--Bob Yantosca (talk) 19:20, 11 December 2019 (UTC)

Data download commands

We recommend that you use the free and open-source wget utility to download data from Compute Canada. Most modern Unix systems have wget already installed.

Basic syntax

The basic formula to download data from Compute Canada to your local server is: 

wget OPTIONS "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"

NOTE: The URL must be enclosed in quotes for file transfer to occur. If you omit the quotes then wget will just return a directory listing in a file named index.html without any files being downloaded.

Commonly used options with wget are:

wget option Description
-np Will not allow ascent to the parent directory
-nH Omits the remote root directory name from the local directory name.
  • i.e. Downloads geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME to local folder ExtData/DIRECTORY_NAME.
-N Downloads only those files having newer timestamps than any local copies.
-P path Copies data to the specified directory
  • e.g. Specifying -P /home/data will copy geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME
    to /home/data/ExtData/DIRECTORY_NAME, etc.
-r Specifies recursive directory transfer (i.e. will download all subdirectories).
-R "*.html" Skips downloading files ending in *.html.

Examples

1. Download remote directory geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME to ./ExtData/DIRECTORY_NAME. 

wget -r -np -nH -N -R "*.html" "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"


2. Similar to Example 1 above, but will download remote directory geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME to ./DIRECTORY_NAME. We have used --cut-dirs=1 to trim one level off the downloaded directory. 

wget -r -np -nH -N -R "*.html" --cut-dirs=1 "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME/"


3. Similar to Example 1 above, but wll download the directory geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME to /pub/gcgrid/data/ExtData/DIRECTORY_NAME: 

wget -r -np -nH -N -R "*.html" -P /pub/gcgrid/data "http://geoschemdata.computecanada.ca/ExtData/DIRECTORY_NAME"
Retrieved from "http://wiki.seas.harvard.edu/geos-chem/index.php?title=Downloading_data_from_WashU&oldid=45719"