Преглед изворни кода

temporal manual: filter example added; some cross-page standardization

git-svn-id: https://svn.osgeo.org/grass/grass/branches/releasebranch_7_0@66425 15284696-431f-4ddb-bdfa-cd5b030d7da7
Markus Neteler пре 9 година
родитељ
комит
ecfbb4b496

+ 8 - 7
temporal/t.rast.export/t.rast.export.html

@@ -1,7 +1,7 @@
 <h2>DESCRIPTION</h2>
 <h2>DESCRIPTION</h2>
 
 
-This module exports a space time raster dataset as a tar archive. The
-archive contains the raster maps either as GeoTIFF files or as GRASS
+<em>t.rast.export</em> exports a space time raster dataset (strds) as a tar
+archive. The archive contains the raster maps either as GeoTIFF files or as GRASS
 binary files exported using <em>r.pack</em>. The map specific color tables
 binary files exported using <em>r.pack</em>. The map specific color tables
 are exported in case of GeoTIFF files. In addition several metadata files
 are exported in case of GeoTIFF files. In addition several metadata files
 are created in the archive that describe the temporal layout.
 are created in the archive that describe the temporal layout.
@@ -15,18 +15,19 @@ the space time raster dataset was exported from. The file "readme.txt"
 describes the file format. The output of <em>r.info</em> is stored in
 describes the file format. The output of <em>r.info</em> is stored in
 "metadata.txt".
 "metadata.txt".
 <p>
 <p>
-The tar archive can be compressed using the <b>compress</b> option.
-Gzip and bzip2 are available. A <b>where</b> option can be specified,
+The tar archive can be compressed using the <b>compress</b> option. Gzip
+and bzip2 (default) are available. A <b>where</b> option can be specified,
 to export only a subset of the space time dataset. Archives exported
 to export only a subset of the space time dataset. Archives exported
-with <em>t.rast.export</em> can be importet with <em>t.rast.import</em>.
+with <em>t.rast.export</em> can be imported with
+<em><a href="t.vect.import.html">t.rast.import</a></em>.
 
 
 <h2>EXAMPLE</h2>
 <h2>EXAMPLE</h2>
 
 
-In this example all the maps of 2012 of tempmean_monthly will be exported
+In this example, all the maps of 2012 of "tempmean_monthly" will be exported:
 
 
 <div class="code"><pre>
 <div class="code"><pre>
 t.rast.export input=tempmean_monthly output=tempmean_monthly.tar.bzip2 \
 t.rast.export input=tempmean_monthly output=tempmean_monthly.tar.bzip2 \
-              where="start_time >= '2012-01-01' and start_time < '2013-01-01'"
+              where="start_time &gt;= '2012-01-01' and start_time &lt; '2013-01-01'"
 
 
 tar xvf precipitation_daily.tar
 tar xvf precipitation_daily.tar
 
 

+ 7 - 5
temporal/t.rast.import/t.rast.import.html

@@ -8,17 +8,20 @@ was exported with <a href="t.rast.export.html">t.rast.export</a>.
 Optionally a base map name can be provided to avoid that existing
 Optionally a base map name can be provided to avoid that existing
 raster maps are overwritten by the map names that are used in the STRDS
 raster maps are overwritten by the map names that are used in the STRDS
 archive.
 archive.
+<p>
+The <b>directory</b> is used as work directory in case of import but
+can also be used as a data directory when using GeoTIFF for the data
+exchange.
 
 
 <h2>EXAMPLE</h2>
 <h2>EXAMPLE</h2>
 
 
-Inside the North Carolina space time dataset it is possible to find a package
-called <em>lst_daily.tar.bzip2</em> with daily data from MODIS LST. Try
-to import it running:
+The North Carolina space time dataset contains a data package called 
+<em>lst_daily.tar.bzip2</em> with daily data from MODIS LST. Import it
+by running:
 
 
 <div class="code"><pre>
 <div class="code"><pre>
 t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
 t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
               basename=lst directory=/tmp
               basename=lst directory=/tmp
-
 </pre></div>
 </pre></div>
 
 
 <h2>SEE ALSO</h2>
 <h2>SEE ALSO</h2>
@@ -37,4 +40,3 @@ t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
 S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 
 
 <p><i>Last changed: $Date$</i>
 <p><i>Last changed: $Date$</i>
-

+ 12 - 2
temporal/t.rast.list/t.rast.list.html

@@ -66,7 +66,7 @@ value major than 24
 <p>
 <p>
 
 
 <div class="code"><pre>
 <div class="code"><pre>
-t.rast.list tempmean_monthly columns=name,start_time,min,max where="max > 24"
+t.rast.list tempmean_monthly columns=name,start_time,min,max where="max &gt; 24"
 name|start_time|min|max
 name|start_time|min|max
 2009_06_tempmean|2009-06-01 00:00:00|15.962669|25.819681
 2009_06_tempmean|2009-06-01 00:00:00|15.962669|25.819681
 2009_07_tempmean|2009-07-01 00:00:00|15.32852|26.103664
 2009_07_tempmean|2009-07-01 00:00:00|15.32852|26.103664
@@ -80,7 +80,7 @@ name|start_time|min|max
 <h3>Filtering the result by time range</h3>
 <h3>Filtering the result by time range</h3>
 
 
 In this example the result is filtered showing only the maps which
 In this example the result is filtered showing only the maps which
-fall into a specified time range
+fall into a specified time range (from .. to):
 <p>
 <p>
 
 
 <div class="code"><pre>
 <div class="code"><pre>
@@ -96,6 +96,16 @@ name|start_time|min|max
 2012_08_tempmean|2012-08-01 00:00:00|15.718526|26.151115
 2012_08_tempmean|2012-08-01 00:00:00|15.718526|26.151115
 </pre></div>
 </pre></div>
 
 
+
+<h3>Filtering the result by selecting recurring timestamps</h3>
+
+In this example the result is filtered showing only the maps which
+fall into a specified recurring time range (here one month per year):
+
+<div class="code"><pre>
+t.rast.list Tseasonal_fieldata_garda where="strftime('%m', start_time)='06'"
+</pre></div>
+
 <h3>Using method option</h3>
 <h3>Using method option</h3>
 
 
 Method option is able to show raster in different way. By default <em>cols</em>
 Method option is able to show raster in different way. By default <em>cols</em>

+ 9 - 12
temporal/t.vect.export/t.vect.export.html

@@ -12,23 +12,23 @@ the number of maps, the chosen export format and some other
 metadata. The "proj.txt" file stores the projection information as a
 metadata. The "proj.txt" file stores the projection information as a
 proj4 string of the location the space time vector dataset was
 proj4 string of the location the space time vector dataset was
 exported from. The file "readme.txt" describes the file format. The
 exported from. The file "readme.txt" describes the file format. The
-output of v.info for each vector map in the space time dataset is
+output of <em>v.info</em> for each vector map in the space time dataset is
 stored in "metadata.txt".
 stored in "metadata.txt".
-
-<p>Gzip or bzip2 (default) compression can be specified with the
-<strong>compress</strong> option. Archives exported with
-<em><a href="t.vect.export.html">t.vect.export</a></em> can be imported
-with <em><a href="t.vect.import.html">t.vect.import</a></em>.
+<p>
+The tar archive can be compressed using the <b>compress</b> option. Gzip
+and bzip2 (default) are available. A <b>where</b> option can be specified,
+to export only a subset of the space time dataset. Archives exported
+with <em>t.vect.export</em> can be imported with
+<em><a href="t.vect.import.html">t.vect.import</a></em>.
 
 
 <h2>EXAMPLE</h2>
 <h2>EXAMPLE</h2>
 
 
-In this example 5 vector maps are created and
+In this example, five vector maps are created and
 registered in a single space time vector dataset named <em>random_locations</em>.
 registered in a single space time vector dataset named <em>random_locations</em>.
 Each vector map represents random locations
 Each vector map represents random locations
 within the boundary of the state taken at 1 month intervals.
 within the boundary of the state taken at 1 month intervals.
 
 
 <div class="code"><pre>
 <div class="code"><pre>
-    
 t.vect.export input=shoreline output=shoreline_nc
 t.vect.export input=shoreline output=shoreline_nc
 
 
 tar xvfj shoreline_nc
 tar xvfj shoreline_nc
@@ -104,17 +104,15 @@ Files:
                  time stamps in ISO-Format. Field separator is |
                  time stamps in ISO-Format. Field separator is |
  metadata.txt -- The output of t.info
  metadata.txt -- The output of t.info
    readme.txt -- This file
    readme.txt -- This file
-
 </pre></div>
 </pre></div>
 
 
-
 <h2>SEE ALSO</h2>
 <h2>SEE ALSO</h2>
 
 
 <em>
 <em>
 <a href="t.vect.import.html">t.vect.import</a>,
 <a href="t.vect.import.html">t.vect.import</a>,
 <a href="t.create.html">t.create</a>,
 <a href="t.create.html">t.create</a>,
 <a href="t.info.html">t.info</a>,
 <a href="t.info.html">t.info</a>,
-<a href="v.in.ogr.html">v.in.ogr</a>,
+<a href="v.out.ogr.html">v.out.ogr</a>,
 <a href="v.unpack.html">v.unpack</a>,
 <a href="v.unpack.html">v.unpack</a>,
 <a href="t.rast.export.html">t.rast.export</a>
 <a href="t.rast.export.html">t.rast.export</a>
 </em>
 </em>
@@ -124,4 +122,3 @@ Files:
 S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 
 
 <p><i>Last changed: $Date$</i>
 <p><i>Last changed: $Date$</i>
-

+ 16 - 9
temporal/t.vect.import/t.vect.import.html

@@ -1,16 +1,23 @@
 <h2>DESCRIPTION</h2>
 <h2>DESCRIPTION</h2>
 
 
-<em>t.vect.import</em> imports a space time vector dataset archive that was 
-created with <a href="t.vect.export.html">t.vect.export</a>.
-Optionally a base map name can be provided to avoid overwriting vector maps  
-used in the space-time vector dataset archive.
+<em>t.vect.import</em> imports a space time vector dataset archive that
+was exported with <a href="t.vect.export.html">t.vect.export</a>.
 
 
+<h2>NOTES</h2>
+
+Optionally a base map name can be provided to avoid that existing
+vector maps are overwritten by the map names that are used in the STRDS
+archive.
+<p>
+The <b>directory</b> is used as work directory in case of import but
+can also be used as a data directory when using GML for the data
+exchange.
 
 
 <h2>EXAMPLE</h2>
 <h2>EXAMPLE</h2>
 
 
-In this example 5 vector maps are created and registered in a single space time 
-vector dataset named <em>random_locations</em>. Each vector map represents 
-random locations within the boundary of the state taken at 1 month intervals. 
+In this example, five vector maps are created and registered in a single space time 
+vector dataset named <em>random_locations</em>. Each vector map represents
+random locations within the boundary of the state taken at 1 month intervals.
 The space time dataset is then exported and re-imported.
 The space time dataset is then exported and re-imported.
 
 
 <div class="code"><pre>
 <div class="code"><pre>
@@ -18,7 +25,7 @@ db.connect -d
 
 
 for i in `seq 1 5` ; do
 for i in `seq 1 5` ; do
     v.random output=map_$i n=500 input=boundary_state@PERMANENT
     v.random output=map_$i n=500 input=boundary_state@PERMANENT
-    echo map_$i >> map_list.txt
+    echo map_$i &gt;&gt; map_list.txt
 done
 done
 
 
 t.create type=stvds temporaltype=absolute \
 t.create type=stvds temporaltype=absolute \
@@ -52,7 +59,7 @@ new_map_5@user1|new_map_5|None|user1|2012-05-01 00:00:00|2012-06-01 00:00:00
 <a href="t.vect.export.html">t.vect.export</a>,
 <a href="t.vect.export.html">t.vect.export</a>,
 <a href="t.create.html">t.create</a>,
 <a href="t.create.html">t.create</a>,
 <a href="t.info.html">t.info</a>,
 <a href="t.info.html">t.info</a>,
-<a href="v.out.ogr.html">v.out.ogr</a>,
+<a href="v.in.ogr.html">v.in.ogr</a>,
 <a href="v.pack.html">v.pack</a>,
 <a href="v.pack.html">v.pack</a>,
 <a href="t.rast.import.html">t.rast.import</a>
 <a href="t.rast.import.html">t.rast.import</a>
 </em>
 </em>