source: lmdz_wrf/trunk/tools/documentation/ncmanage/CFmorzization.html @ 1859

Last change on this file since 1859 was 1859, checked in by lfita, 7 years ago

Adding documentation
File size: 9.0 KB
Line 
1<HTML>
2  <HEAD>
3    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8">
4    <LINK REL="stylesheet" TYPE="text/css" HREF="../PyNCplot.css"/>
5  </HEAD>
6
7  </HEAD>
8  <BODY>
9    <DIV CLASS="valheader">
10      CFmorzization
11    </DIV>
12    <DIV CLASS="valimg">
13    <P STYLE="text-align:left;">
14      Provide a CF-compilation version of a variable within a file.
15      See further details at:
16      <UL>
17        <LI><A HREF="http://cordex.org/publications/report-and-document-archives/" TARGET="_blank" CLASS="lc">Christensen, Gutowski, Nikulin, and Legutke; 2013. CORDEX Archive Design</A></LI>
18        <LI><A HREF="http://cmip-pcmdi.llnl.gov/cmip5/output_req.html#metadata" TARGET="_bkan" CLASS="lc">Taylor, K., and C. Doutriaux, 2011. CMIP5 Model Output Requirements: File Contents and Format, Data Structure and Meta Data</A></LI>
19      </UL>
20    </P>
21    </DIV>
22    <DIV CLASS="valhelp">
23    varaddattr(values, ncfile, varn)<BR>
24    &bnsp;&bnsp;values=[dimvarns]:[globattrfile]:[projectfile]<BR>
25    &bnsp;&bnsp;&bnsp;&bnsp;[dimvarns]: ',' separated list for identification of axes, dimensions and <BR>
26    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;variable-dimensions as '[AXIS]|[dimn]|[vardimn]'<BR>
27    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[AXIS]: axis of the file: 'X', 'Y', 'Z', or 'T'<BR>
28    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[dimn]: name of the current name of the dimension of the given axis<BR>
29    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[vardimn]: name of the current name of the variable-dimension of the <BR>
30    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;given axis<BR>
31    &bnsp;&bnsp;&bnsp;&bnsp;[globattrfilen]: name of ASCII file with the given metadata to be added as global attributes<BR>
32    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;with a line per attribute [attrname] [value](use '!' for spaces] (underparenthesis for description)<BR>
33    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;use '#' for comments<BR>
34    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;File has to have at least:<BR>
35    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;institute_id [value] (CV)<BR>
36    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;institution  [value]<BR>
37    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;model_id [value] (CORDEX starts with &lt;institute_id&gt;-)<BR>
38    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;experiment_id [value] (same CV as CMIP5 with "evaluation" in addition)<BR>
39    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;experiment [value] (long version of "experiment_id")<BR>
40    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;contact [value] ([Name], [email] of contact person)<BR>
41    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;product [value] (single value: "output")<BR>
42    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;Conventions [value] (later than CF1.4 if present / single value: "CF-1.4")<BR>
43    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;creation_date [value] ([YYYY-MM-DDTHH:MM:SSZ] format according to UNIDATA conventions, same in CMIP5 & CORDEX)<BR>
44    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;frequency [value] (same CV as CMIP5 with "sem" in addition; 3hr highest freq. in CORDEX; no "yr")<BR>
45    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;driving_model_id [value] (CMIP5 institute_id, &lt;CMIP5 institute_id&gt;-&lt;member in CMIP5 CV list of model_id&gt;)<BR>
46    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;driving_model_ensemble_member [value] (CMIP5 CV, e.g. "r1i1p1")<BR>
47    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;driving_experiment_name [value] ("evaluation" or &lt;member in CMIP5 CV list of experiment_id&gt;)<BR>
48    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;driving_experiment [value] ("&lt;driving_model_id&gt;,&lt;driving_experiment_name&gt;,&lt;driving_model_ensemble_member&gt;", <BR>
49    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;members of the CMIP5 list of forcing agents are not necessarily forcing agents of RCM (besides implicitly<BR>
50    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;in driving_experimnt)<BR>
51    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;rcm_version_id [value] (&lt;free text string&gt;; valid characters only indicates model modifs during the project<BR>
52    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;e.g.: parameterizations, small upgrades)<BR>
53    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;project_id [value] (single value)<BR>
54    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;CORDEX_domain [value] ((e.g.: "AFR-44", "AFR-44i", includes resolution acronym)<BR>
55    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;tracking_id [value] (not required or explained in ADD; it is, however, strongly recommended to include it <BR>
56    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;as prescribed CMIP5.)<BR>
57    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;basetime [value] (reference time "1949-12-01T00:00:00Z" formatted acording to UNIDATA conventions)<BR>
58    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;calendar [value] (CF conventions as in driving model)<BR>
59    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;grid [value] (according to CF conventions)<BR>
60    &bnsp;&bnsp;&bnsp;&bnsp;[projectfile]: ASCII file with all the CF-mandatory projection information. A line for each attribute. Name of <BR>
61    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;the variable to be used to refer the projection inside the file will be the same as global attribute `grid'<BR>
62    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;See more information from: <A HREF="http://cfconventions.org/Data/cf-conventions/cf-conventions-1.7/build/ch05s06.html" TARGET="_blan" CLASS="lc">CF-conventions</A><BR>
63    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; (...) (specific projection attributes and values)<BR>
64    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; [name] [value] [kind] ('I': integer, 'R': float, 'D': double float, 'S': string)<BR>
65    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; Add three more attributes for the resolution of the projection:<BR>
66    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; x_resolution [value] (resolution along x-axis)<BR>
67    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; y_resoltuion [value] (resolution along y-axis)<BR>
68    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp; proj_units [value] (units of the resoltion of the projection)<BR>
69    &bnsp;&bnsp;ncfile= netCDF file to use<BR>
70    &bnsp;&bnsp;variable= ',' list of [varfn]@[method]@[Tbnds] to CF transform. A separated file will be <BR>
71    &bnsp;&bnsp;&bnsp;&bnsp;created for each variable<BR>
72    &bnsp;&bnsp;&bnsp;&bnsp;use [varfn]@instantaneous@None for instantaneous values<BR>
73    &bnsp;&bnsp;&bnsp;&bnsp;NOTE: CF values will be taken from 'variables_values.dat'<BR>
74    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[varfn]: name of the variable inside the file<BR>
75    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[method]: cell_method of the variable ('!' for spaces) uing, standard CF description:<BR> 
76    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;<A HREF="http://cfconventions.org/cf-conventions/cf-conventions.html#_data_representative_of_cells" TARGET="_blank" CLASS="lc">CF-conventions cell representation</A><BR>
77    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[var_time_bnds]: variable with the time_bnds values, or:<BR>
78    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;* 'WRFtime_bnds'|[tunit]|[quantity], to be computed directly from WRF for a given period of time as:<BR>
79    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[tunit]: unit of time: 'c' century, 'y' year, 'm' month, 'w' week, 'd' day, <BR>
80    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;'h' hour, 'i' minute, 's' second<BR>
81    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[quantity] = amount (integer) of [tunit] to cover a period of time_bnds<BR>
82    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;* 'Ctime_bnds'|[tvarn]|[tunit]|[quantity], to be computed directly from a variable from a given period of time as:<BR>
83    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[tvarn]: name of the variable<BR>
84    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[tunit]: unit of time: 'c' century, 'y' year, 'm' month, 'w' week, 'd' day,<BR> 
85    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;'h' hour, 'i' minute, 's' second<BR>
86    &bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;&bnsp;[quantity] = amount (integer) of [tunit] to cover a period of time_bnds<BR>
87    </DIV>
88    <DIV CLASS="valins">
89      $ python ${pyHOME}/nc_var.py -o CFmorzization -S 'X|west_east|XLONG,Y|south_north|XLAT,T|Time|WRFtime,Z|bottom_top|ZNU:GlobalAttr1995.inf:proj1995.inf' -f ~/PY/wrfout_d01_1995-01-01_00\:00\:00 -v QFX@instantaneous@None<BR>
90      $ python ${pyHOME}/nc_var.py -o CFmorzization -S 'X|west_east|XLONG,Y|south_north|XLAT,T|Time|WRFtime,Z|bottom_top|ZNU:GlobalAttr1995.inf:proj1995.inf' -f ~/PY/wrfout_d01_1995-01-01_00\:00\:00 -v 'RAINC@time:!accumulation@WRFtime_bnds|h|3'
91    </DIV>
92  </BODY>
93</HTML>
94
Note: See TracBrowser for help on using the repository browser.