sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r981703 - /websites/staging/sis/trunk/content/
Date Thu, 03 Mar 2016 00:25:49 GMT
Author: buildbot
Date: Thu Mar  3 00:25:49 2016
New Revision: 981703

Log:
Staging update by buildbot for sis

Modified:
    websites/staging/sis/trunk/content/   (props changed)
    websites/staging/sis/trunk/content/branches.html
    websites/staging/sis/trunk/content/build.html
    websites/staging/sis/trunk/content/code-patterns.html
    websites/staging/sis/trunk/content/command-line.html
    websites/staging/sis/trunk/content/contributor.html
    websites/staging/sis/trunk/content/downloads.html
    websites/staging/sis/trunk/content/faq.html
    websites/staging/sis/trunk/content/index.html
    websites/staging/sis/trunk/content/license.html
    websites/staging/sis/trunk/content/mail-lists.html
    websites/staging/sis/trunk/content/release-management-setup.html
    websites/staging/sis/trunk/content/release-management.html
    websites/staging/sis/trunk/content/site-management.html
    websites/staging/sis/trunk/content/source.html
    websites/staging/sis/trunk/content/team-list.html

Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Mar  3 00:25:49 2016
@@ -1 +1 @@
-1733388
+1733395

Modified: websites/staging/sis/trunk/content/branches.html
==============================================================================
--- websites/staging/sis/trunk/content/branches.html (original)
+++ websites/staging/sis/trunk/content/branches.html Thu Mar  3 00:25:49 2016
@@ -315,7 +315,7 @@ svn commit --message <span class="s2">&q
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/build.html
==============================================================================
--- websites/staging/sis/trunk/content/build.html (original)
+++ websites/staging/sis/trunk/content/build.html Thu Mar  3 00:25:49 2016
@@ -236,7 +236,7 @@ This plugin performs a work similar to t
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/code-patterns.html
==============================================================================
--- websites/staging/sis/trunk/content/code-patterns.html (original)
+++ websites/staging/sis/trunk/content/code-patterns.html Thu Mar  3 00:25:49 2016
@@ -196,7 +196,7 @@ it shall not be used for exceptions thro
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/command-line.html
==============================================================================
--- websites/staging/sis/trunk/content/command-line.html (original)
+++ websites/staging/sis/trunk/content/command-line.html Thu Mar  3 00:25:49 2016
@@ -103,6 +103,7 @@ h2:hover > .headerlink, h3:hover > .head
 <li><a href="#usage">Usage</a></li>
 <li><a href="#examples">Examples</a><ul>
 <li><a href="#crs">Extracting ISO 19111 Coordinate Reference System (CRS)</a></li>
+<li><a href="#identifier">Extracting EPSG identifier from a Coordinate Reference
System</a></li>
 <li><a href="#metadata">Extracting ISO 19115 Metadata</a></li>
 </ul>
 </li>
@@ -167,7 +168,7 @@ For executing a command, the syntax is:<
 However all commands support the <code>--help</code> option, which lists the
options available for that command.
 Available options will be from the following list:</p>
 <table>
-  <tr><td><code>--format</code></td>   <td>The output
format: xml, wkt, wkt1 or text.</td></tr>
+  <tr><td><code>--format</code></td>   <td>The output
format: <code>xml</code>, <code>wkt</code>, <code>wkt1</code>
or <code>text</code>.</td></tr>
   <tr><td><code>--locale</code></td>   <td>The locale
to use for the command output.</td></tr>
   <tr><td><code>--timezone</code></td> <td>The timezone
for the dates to be formatted.</td></tr>
   <tr><td><code>--encoding</code></td> <td>The encoding
to use for the command output.</td></tr>
@@ -183,34 +184,128 @@ but usually do not apply to the error me
 The reason is that command output may be targeted to a client, while the error messages are
usually for the operator.</p>
 <h1 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent
link">&para;</a></h1>
 <h2 id="crs">Extracting ISO 19111 Coordinate Reference System (CRS)<a class="headerlink"
href="#crs" title="Permanent link">&para;</a></h2>
-<p>SIS can read a Coordinate Reference System definition from the <em>Well Known
Text</em> (WKT) format version 1 and 2,
-or from <em>Geographic Markup Language</em> (GML) version 3.2.
-The following example show the CRS of a GML file accessible from the web:</p>
-<div class="codehilite"><pre>sis crs http://svn.apache.org/repos/asf/sis/trunk/core/sis-referencing/src/test/resources/org/apache/sis/referencing/crs/ProjectedCRS.xml
--format WKT
+<p>SIS can read Coordinate Reference System (CRS) definitions from various sources:</p>
+<ul>
+<li>Code from the EPSG geodetic dataset</li>
+<li><em>Well Known Text</em> (WKT) format version 1 and 2</li>
+<li><em>Geographic Markup Language</em> (GML) version 3.2</li>
+</ul>
+<p>The easiest way is see a CRS definition is to use an EPSG code.
+The <a href="http://www.epsg.org/">EPSG geodetic dataset</a> is a widely-used
source of definitions for thousands of Coordinate Reference Systems.
+Appache SIS provides a <a href="book/tables/CoordinateReferenceSystems.html">list of
supported codes</a>, which can be queried from the command line.
+For example the following command prints the definition of the <em>"JGD2011 / Japan
Plane Rectangular CS VIII"</em> Coordinate Reference System:</p>
+<div class="codehilite"><pre>sis crs EPSG:6676
 </pre></div>
 
 
+<p>The first time that a command requires the EPSG dataset, Apache SIS will propose
to download and install a local copy.
+This automatic download happen only when using the command-line tools described in this page.
+Developers who wish to use the EPSG dataset in their applications can use the Maven artifact
documented in (TODO).</p>
 <p><details>
-  <summary>The above command output should produce the following output:</summary>
-<pre>PROJCRS["NTF (Paris) / Lambert zone II",
-  BASEGEODCRS["NTF (Paris)",
-    DATUM["Nouvelle Triangulation Francaise",
-      ELLIPSOID["Clarke 1880 (IGN)", 6378249.2, 293.4660212936269, LENGTHUNIT["metre", 1]]],
-      PRIMEM["Paris", 2.5969213, ANGLEUNIT["grade", 0.015707963267948967]]],
-  CONVERSION["Lambert zone II",
-    METHOD["Lambert Conic Conformal (1SP)", ID["EPSG", 9801]],
-    PARAMETER["Latitude of natural origin", 52.0, ANGLEUNIT["grade", 0.015707963267948967],
ID["EPSG", 8801]],
-    PARAMETER["Longitude of natural origin", 0.0, ANGLEUNIT["grade", 0.015707963267948967],
ID["EPSG", 8802]],
-    PARAMETER["Scale factor at natural origin", 0.99987742, SCALEUNIT["unity", 1], ID["EPSG",
8805]],
-    PARAMETER["False easting", 600000.0, LENGTHUNIT["metre", 1], ID["EPSG", 8806]],
-    PARAMETER["False northing", 2200000.0, LENGTHUNIT["metre", 1], ID["EPSG", 8807]]],
+  <summary>The above command should produce the following output (click to expand):</summary>
+<pre>ProjectedCRS["JGD2011 / Japan Plane Rectangular CS VIII",
+  BaseGeodCRS["JGD2011",
+    Datum["Japanese Geodetic Datum 2011",
+      Ellipsoid["GRS 1980", 6378137.0, 298.257222101]],
+    Unit["degree", 0.017453292519943295]],
+  Conversion["Japan Plane Rectangular CS zone VIII",
+    Method["Transverse Mercator"],
+    Parameter["Latitude of natural origin", 36.0],
+    Parameter["Longitude of natural origin", 138.5],
+    Parameter["Scale factor at natural origin", 0.9999],
+    Parameter["False easting", 0.0],
+    Parameter["False northing", 0.0]],
   CS[Cartesian, 2],
-    AXIS["Easting (E)", east, ORDER[1]],
-    AXIS["Northing (N)", north, ORDER[2]],
-    LENGTHUNIT["metre", 1],
-  SCOPE["Large and medium scale topographic mapping and engineering survey."],
-  ID["EPSG", 27572, URI["urn:ogc:def:crs:EPSG::27572"]]]</pre>
+    Axis["Northing (X)", north],
+    Axis["Easting (Y)", east],
+    Unit["metre", 1],
+  Scope["Large and medium scale topographic mapping, cadastral and engineering survey."],
+  Area["Japan - onshore - Honshu between approximately 137°45'E and 139°E - Niigata-ken;
Nagano-ken; Yamanashi-ken; Shizuoka-ken."],
+  BBox[34.54, 137.32, 38.58, 139.91],
+  Id["EPSG", 6676, "8.9", URI["urn:ogc:def:crs:EPSG:8.9:6676"]],
+  Remark["Replaces JGD2000 / Japan Plane Rectangular CS VIII (CRS code 2450) with effect
from 21st October 2011."]]</pre>
 </details></p>
+<p>The above output is compatible with version 2 of <em>Well Known Text</em>
(WKT) format.
+However some applications are restricted to WKT version 1.
+For an output using the legacy WKT 1 format, one can add the <code>--format wkt1</code>
option to the above command.</p>
+<p>The “WKT 2” specification allows some flexibility in keyword names and
in the way to specify units of measurement.
+By default, the command-line uses this flexibility for producing less verbose but still legal
WKT 2 output.
+If an output closer to the WKT 2 recommendations is desired, one can add the <code>--format
wkt2</code> option to the above command.</p>
+<p>Apache SIS can also read and write CRS definitions in the <em>Geographic Markup
Language</em> (GML) format.
+For GML output, one can add the <code>--format xml</code> option to the above
command.
+Note that the result is quite verbose.</p>
+<h2 id="identifier">Extracting EPSG identifier from a Coordinate Reference System<a
class="headerlink" href="#identifier" title="Permanent link">&para;</a></h2>
+<p>Because the EPSG geodetic dataset is so commonly used,
+it is very common to define a CRS by only its EPSG code instead than its full definition.
+Such codes can be written as “<code>EPSG:4326</code>” or “<code>urn:ogc:def:crs:EPSG::4326</code>”
for instance.
+In a <em>Well Known Text</em> (WKT) string, the code appears at the bottom of
the definition
+in an element like <code>ID["EPSG", 4326]</code> or <code>AUTHORITY["EPSG",
"4326"]</code>.
+However in many case the code is missing.
+But Apache SIS can find it by comparing a given CRS against the definitions in the EPSG database.</p>
+<p>The following example read a WKT for the <em>“NTF (Paris) / Lambert zone
II”</em> Coordinate Reference System,
+but in which the <code>ID["EPSG", 27572]</code> has been intentionally omitted.
+Furthermore, the <em>“NTF (Paris) / Lambert zone II”</em> name has
been replaced by <em>“NTF (Paris) / zone to be discovered by the demo”</em>
+Executing the following command:</p>
+<div class="codehilite"><pre>sis identifier http://sis.staging.apache.org/examples/MissingIdentifier.wkt
+</pre></div>
+
+
+<p>produces an output like below:</p>
+<div class="codehilite"><pre>    urn:ogc:def:crs:EPSG:8.9:27572    | NTF (Paris)
/ Lambert zone II
+</pre></div>
+
+
+<p>As we can see, SIS has been able to find back the identifier code and the actual
CRS name.</p>
+<p>Sometime a WKT declares wrongly an EPSG code.
+The most frequent case is a WKT that defines a Coordinate Reference System with (<em>longitude</em>,
<em>latitude</em>) axes,
+but declare an EPSG code for a CRS with (<em>latitude</em>, <em>longitude</em>)
axes.
+Apache SIS can detect such mismatch.
+For example executing the following command:</p>
+<div class="codehilite"><pre>sis identifier http://sis.staging.apache.org/examples/WrongAxisOrder.wkt
+</pre></div>
+
+
+<p>produces an output like below:</p>
+<div class="codehilite"><pre>!   urn:ogc:def:crs:EPSG:8.9:4979    | WGS 84
+
+Legend:
+!   Identified object matches definition provided by authority except for coordinate system
axes.
+</pre></div>
+
+
+<p>Apache SIS can perform such analysis because it “understands” the CRS
definition.
+This analysis capability can be tested by altering the CRS definition.
+The following example asks the identifier of a CRS which is normally defined as below:</p>
+<div class="codehilite"><pre>ProjectedCRS[&quot;WGS 84 / Mercator 41&quot;,
+  (... definition omitted for brevity ...)
+    Method[&quot;Mercator (variant B)&quot;],
+    Parameter[&quot;Latitude of 1st standard parallel&quot;, -41.0],
+  (... definition omitted for brevity ...)
+</pre></div>
+
+
+<p>However in this example, we will provide a CRS defined as below:</p>
+<div class="codehilite"><pre>ProjectedCRS[&quot;Scaled Mercator&quot;,
+  (... definition omitted for brevity ...)
+    Method[&quot;Mercator (variant A)&quot;],
+    Parameter[&quot;Scale factor at natural origin&quot;, 0.7557992272019596&quot;],
+    Parameter[&quot;Latitude of natural origin&quot;, -0.0],
+  (... definition omitted for brevity ...)
+</pre></div>
+
+
+<p>Executing the following command:</p>
+<div class="codehilite"><pre>sis identifier http://sis.staging.apache.org/examples/EquivalentDefinition.wkt
+</pre></div>
+
+
+<p>produces an output like below:</p>
+<div class="codehilite"><pre>    urn:ogc:def:crs:EPSG:8.9:3994    | WGS 84 /
Mercator 41
+</pre></div>
+
+
+<p>Apache SIS has been able to detect that the second CRS is numerically equivalent
to the first one,
+and return the identifier for the CRS that we should use.</p>
 <h2 id="metadata">Extracting ISO 19115 Metadata<a class="headerlink" href="#metadata"
title="Permanent link">&para;</a></h2>
 <p>SIS can read the header of a data file and print the metadata in an ISO 19115 structure.
 The data file given in argument can be a local file or a URL.
@@ -276,7 +371,7 @@ a small Java program using the <a href="
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/contributor.html
==============================================================================
--- websites/staging/sis/trunk/content/contributor.html (original)
+++ websites/staging/sis/trunk/content/contributor.html Thu Mar  3 00:25:49 2016
@@ -264,7 +264,7 @@ Developers can specify default propertie
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/downloads.html
==============================================================================
--- websites/staging/sis/trunk/content/downloads.html (original)
+++ websites/staging/sis/trunk/content/downloads.html Thu Mar  3 00:25:49 2016
@@ -192,7 +192,7 @@ Below are examples of declarations in a
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/faq.html
==============================================================================
--- websites/staging/sis/trunk/content/faq.html (original)
+++ websites/staging/sis/trunk/content/faq.html Thu Mar  3 00:25:49 2016
@@ -155,7 +155,7 @@ The attribute values will be wrapped aut
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/index.html
==============================================================================
--- websites/staging/sis/trunk/content/index.html (original)
+++ websites/staging/sis/trunk/content/index.html Thu Mar  3 00:25:49 2016
@@ -147,7 +147,7 @@ The version under development is 0.7-SNA
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/license.html
==============================================================================
--- websites/staging/sis/trunk/content/license.html (original)
+++ websites/staging/sis/trunk/content/license.html Thu Mar  3 00:25:49 2016
@@ -277,7 +277,7 @@ limitations under the License.
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/mail-lists.html
==============================================================================
--- websites/staging/sis/trunk/content/mail-lists.html (original)
+++ websites/staging/sis/trunk/content/mail-lists.html Thu Mar  3 00:25:49 2016
@@ -138,7 +138,7 @@ any changes to the sis code and document
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/release-management-setup.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management-setup.html (original)
+++ websites/staging/sis/trunk/content/release-management-setup.html Thu Mar  3 00:25:49 2016
@@ -283,7 +283,7 @@ together with the PGP key name:</p>
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/release-management.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management.html (original)
+++ websites/staging/sis/trunk/content/release-management.html Thu Mar  3 00:25:49 2016
@@ -647,7 +647,7 @@ all directories starting with the old ve
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/site-management.html
==============================================================================
--- websites/staging/sis/trunk/content/site-management.html (original)
+++ websites/staging/sis/trunk/content/site-management.html Thu Mar  3 00:25:49 2016
@@ -268,7 +268,7 @@ Then:</p>
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/source.html
==============================================================================
--- websites/staging/sis/trunk/content/source.html (original)
+++ websites/staging/sis/trunk/content/source.html Thu Mar  3 00:25:49 2016
@@ -379,7 +379,7 @@ Note that a <a href="http://www.mathjax.
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>

Modified: websites/staging/sis/trunk/content/team-list.html
==============================================================================
--- websites/staging/sis/trunk/content/team-list.html (original)
+++ websites/staging/sis/trunk/content/team-list.html Thu Mar  3 00:25:49 2016
@@ -127,7 +127,7 @@ h2:hover > .headerlink, h3:hover > .head
 
   <footer class="footer">
     <div class="container">
-      <p>Copyright &copy; 2013-2015 The Apache Software Foundation, Licensed under
the
+      <p>Copyright &copy; 2013-2016 The Apache Software Foundation, Licensed under
the
         <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
           Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
     </div>



Mime
View raw message