sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1815696 - in /sis/site/trunk: book/en/annexes/geoapi/ book/en/geometry/ book/en/introduction/ book/en/overview/ book/en/referencing/ book/fr/annexes/geoapi/ book/fr/geometry/ book/fr/introduction/ book/fr/overview/ book/fr/referencing/ con...
Date Sat, 18 Nov 2017 21:22:30 GMT
Author: desruisseaux
Date: Sat Nov 18 21:22:29 2017
New Revision: 1815696

URL: http://svn.apache.org/viewvc?rev=1815696&view=rev
Log:
Tune syntax highlighting.

Modified:
    sis/site/trunk/book/en/annexes/geoapi/ReduceDependency.html
    sis/site/trunk/book/en/geometry/GeometryBase.html
    sis/site/trunk/book/en/introduction/AboutBook.html
    sis/site/trunk/book/en/overview/DataAccess.html
    sis/site/trunk/book/en/referencing/CoordinateOperations.html
    sis/site/trunk/book/fr/annexes/geoapi/ReduceDependency.html
    sis/site/trunk/book/fr/geometry/GeometryBase.html
    sis/site/trunk/book/fr/introduction/AboutBook.html
    sis/site/trunk/book/fr/overview/DataAccess.html
    sis/site/trunk/book/fr/referencing/CoordinateOperations.html
    sis/site/trunk/content/book/en/developer-guide.html
    sis/site/trunk/content/book/fr/developer-guide.html

Modified: sis/site/trunk/book/en/annexes/geoapi/ReduceDependency.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/annexes/geoapi/ReduceDependency.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/en/annexes/geoapi/ReduceDependency.html [UTF-8] (original)
+++ sis/site/trunk/book/en/annexes/geoapi/ReduceDependency.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -113,7 +113,7 @@ public class MyApplication {
     public void createMyDatum() {
         ServiceLoader  loader = ServiceLoader.load(DatumFactory.class);
         DatumFactory  factory = loader.iterator().next();
-        GeodeticDatum myDatum = factory.<code class="GeoAPI">createGeodeticDatum</code>(…);
+        GeodeticDatum myDatum = factory.createGeodeticDatum(…);
     }
 }</code></pre>
 

Modified: sis/site/trunk/book/en/geometry/GeometryBase.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/geometry/GeometryBase.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/en/geometry/GeometryBase.html [UTF-8] (original)
+++ sis/site/trunk/book/en/geometry/GeometryBase.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -43,7 +43,7 @@
         To better represent this concept, the <abbr>ISO</abbr> standard and GeoAPI define a <code class="OGC">TransfiniteSet</code> interface
         which we could see as a <code>Set</code> of infinite size.
         Although a parent relationship exists conceptually between these interfaces,
-        GeoAPI does not define <code class="GeoAPI">TransfiniteSet</code> as a sub-interface of <code>java.util.Set</code>,
+        GeoAPI does not define <code>TransfiniteSet</code> as a sub-interface of <code>java.util.Set</code>,
         as the definition of certain methods such as <code>size()</code> and <code>iterator()</code> would be problematic.
         However, we find very similar methods such as <code class="GeoAPI">contains(…)</code> and <code class="GeoAPI">intersects(…)</code>.
       </p>

Modified: sis/site/trunk/book/en/introduction/AboutBook.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/introduction/AboutBook.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/en/introduction/AboutBook.html [UTF-8] (original)
+++ sis/site/trunk/book/en/introduction/AboutBook.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -38,25 +38,26 @@
       <p>
         The elements defined in a computer language, such as classes and methods in Java or elements in an <abbr>XML</abbr> document,
         appear in monospaced font.
-        In order to facilitate an understanding of the relationships between Apache <abbr>SIS</abbr> and the standards, these elements are also represented using the following colour codes:
+        In order to facilitate an understanding of the relationships between Apache <abbr>SIS</abbr> and the standards,
+        these elements are also represented using the following colour codes:
       </p>
       <ul>
         <li>
-          Elements defined in the <abbr title="Open Geospatial Consortium">OGC</abbr> standard
-          or the <abbr title="International Organization for Standardization">ISO</abbr> standard appear in blue.
+          Elements in blue are defined in an <abbr title="Open Geospatial Consortium">OGC</abbr> standard
+          or an <abbr title="International Organization for Standardization">ISO</abbr> standard.
           Example: <code>CD_Ellipsoid</code>.
         </li>
         <li>
-          Elements defined in GeoAPI appear in green.
+          Elements in green are defined in GeoAPI.
           Example: <code>Ellipsoid</code>.
         </li>
         <li>
-          Elements defined in Apache <abbr title="Spatial Information System">SIS</abbr> appear in brown.
+          Elements in brown are defined in Apache <abbr title="Spatial Information System">SIS</abbr>.
           Example: <code>DefaultEllipsoid</code>.
         </li>
         <li>
-          Other elements, such as those in standard Java, are left in black.
-          Example: <code>String</code>.
+          Elements left in black are either defined elsewhere (example: <code>String</code>),
+          or there is simply no emphasis on that element for the discussion.
         </li>
       </ul>
       <p>

Modified: sis/site/trunk/book/en/overview/DataAccess.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/overview/DataAccess.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/en/overview/DataAccess.html (original)
+++ sis/site/trunk/book/en/overview/DataAccess.html Sat Nov 18 21:22:29 2017
@@ -80,12 +80,12 @@
         </p>
 
 <pre><code>try (DataStore ds = DataStores.open(new File("LC81230522014071LGN00_MTL.txt"))) {
-    Metadata md = ds.getMetadata();
+    Metadata md = ds.<code class="SIS">getMetadata()</code>;
 
     // In order to make this example simpler, null values and empty collection checks are omited.
-    Identification   idInfo = md    .getIdentificationInfo().iterator().next();
-    Extent           extent = idInfo.getExtents()           .iterator().next();
-    GeographicExtent bbox   = extent.getGeographicElements().iterator().next();
+    Identification   idInfo = md    .<code class="GeoAPI">getIdentificationInfo()</code>.iterator().next();
+    Extent           extent = idInfo.<code class="GeoAPI">getExtents()</code>           .iterator().next();
+    GeographicExtent bbox   = extent.<code class="GeoAPI">getGeographicElements()</code>.iterator().next();
 
     System.out.println("The geographic bounding box is:");
     System.out.println(bbox);

Modified: sis/site/trunk/book/en/referencing/CoordinateOperations.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/en/referencing/CoordinateOperations.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/en/referencing/CoordinateOperations.html [UTF-8] (original)
+++ sis/site/trunk/book/en/referencing/CoordinateOperations.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -64,7 +64,7 @@
         is to use the <code>org.apache.sis.referencing.CRS</code> convenience class:
       </p>
 
-<pre><code>CoordinateOperation cop = CRS.findOperation(sourceCRS, targetCRS, areaOfInterest);</code></pre>
+<pre><code>CoordinateOperation cop = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, areaOfInterest);</code></pre>
 
       <p>
         Among the information provided by <code>CoordinateOperation</code> object, the following are of special interest:
@@ -133,7 +133,7 @@ public class MyApp {
     public static void main(String[] args) throws FactoryException, TransformException {
         CoordinateReferenceSystem sourceCRS = CommonCRS.WGS84.geographic();
         CoordinateReferenceSystem targetCRS = CommonCRS.WGS84.UTM(40, 14);  // Get whatever zone is valid for 14°E.
-        CoordinateOperation operation = CRS.findOperation(sourceCRS, targetCRS, null);
+        CoordinateOperation operation = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, null);
 
         // The above lines are costly and should be performed only once before to project many points.
         // In this example, the operation that we got is valid for coordinates in geographic area from

Modified: sis/site/trunk/book/fr/annexes/geoapi/ReduceDependency.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/annexes/geoapi/ReduceDependency.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/fr/annexes/geoapi/ReduceDependency.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/annexes/geoapi/ReduceDependency.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -115,7 +115,7 @@ public class MyApplication {
     public void createMyDatum() {
         ServiceLoader  loader = ServiceLoader.load(DatumFactory.class);
         DatumFactory  factory = loader.iterator().next();
-        GeodeticDatum myDatum = factory.<code class="GeoAPI">createGeodeticDatum</code>(…);
+        GeodeticDatum myDatum = factory.createGeodeticDatum(…);
     }
 }</code></pre>
 

Modified: sis/site/trunk/book/fr/geometry/GeometryBase.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/geometry/GeometryBase.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/fr/geometry/GeometryBase.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/geometry/GeometryBase.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -42,7 +42,7 @@
         à ceci près que le nombre d’éléments contenus dans cet ensemble est infini (à l’exception des géométries représentant un simple point).
         Pour mieux représenter ce concept, la norme <abbr>ISO</abbr> et GeoAPI définissent une interface <code class="OGC">TransfiniteSet</code>
         que l’on peut voir comme un <code>Set</code> de taille infini. Bien qu’un lien de parenté existe conceptuellement entre ces interfaces,
-        GeoAPI ne définit pas <code class="GeoAPI">TransfiniteSet</code> comme une sous-interface de <code>java.util.Set</code>
+        GeoAPI ne définit pas <code>TransfiniteSet</code> comme une sous-interface de <code>java.util.Set</code>
         car la définition de certaines méthodes telles que <code>size()</code> et <code>iterator()</code> serait problématique.
         On y retrouve toutefois des méthodes très similaires telles que <code class="GeoAPI">contains(…)</code> et <code class="GeoAPI">intersects(…)</code>.
       </p>

Modified: sis/site/trunk/book/fr/introduction/AboutBook.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/introduction/AboutBook.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/fr/introduction/AboutBook.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/introduction/AboutBook.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -43,21 +43,21 @@
       </p>
       <ul>
         <li>
-          Les éléments définis dans un standard de l’<abbr title="Open Geospatial Consortium">OGC</abbr>
-          ou de l’<abbr title="International Organization for Standardization">ISO</abbr> apparaissent en bleu.
+          Les éléments en bleu sont définis dans un standard de l’<abbr title="Open Geospatial Consortium">OGC</abbr>
+          ou de l’<abbr title="International Organization for Standardization">ISO</abbr>.
           Exemple: <code>CD_Ellipsoid</code>.
         </li>
         <li>
-          Les éléments définis dans GeoAPI apparaissent en vert.
+          Les éléments en vert sont définis dans GeoAPI.
           Exemple: <code>Ellipsoid</code>.
         </li>
         <li>
-          Les éléments définis dans Apache <abbr title="Spatial Information System">SIS</abbr> apparaissent en brun.
+          Les éléments en brun sont définis dans Apache <abbr title="Spatial Information System">SIS</abbr>.
           Exemple: <code>DefaultEllipsoid</code>.
         </li>
         <li>
-          Les autres éléments, notamment ceux du Java standard, sont laissés en noir.
-          Exemple: <code>String</code>.
+          Les éléments laissés en noir sont soient définis ailleurs (exemple: <code>String</code>),
+          ou ne font pas l’objet d’une emphase particulière pour la discussion.
         </li>
       </ul>
       <p>

Modified: sis/site/trunk/book/fr/overview/DataAccess.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/overview/DataAccess.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/fr/overview/DataAccess.html (original)
+++ sis/site/trunk/book/fr/overview/DataAccess.html Sat Nov 18 21:22:29 2017
@@ -82,12 +82,12 @@
         </p>
 
 <pre><code>try (DataStore ds = DataStores.open(new File("LC81230522014071LGN00_MTL.txt"))) {
-    Metadata md = ds.getMetadata();
+    Metadata md = ds.<code class="SIS">getMetadata()</code>;
 
     // Afin de simplifier cet exemple, nous omettons les vérifications de valeurs nulles ou de collections vides.
-    Identification   idInfo = md    .getIdentificationInfo().iterator().next();
-    Extent           extent = idInfo.getExtents()           .iterator().next();
-    GeographicExtent bbox   = extent.getGeographicElements().iterator().next();
+    Identification   idInfo = md    .<code class="GeoAPI">getIdentificationInfo()</code>.iterator().next();
+    Extent           extent = idInfo.<code class="GeoAPI">getExtents()</code>           .iterator().next();
+    GeographicExtent bbox   = extent.<code class="GeoAPI">getGeographicElements()</code>.iterator().next();
 
     System.out.println("La région géographique des données est:");
     System.out.println(bbox);

Modified: sis/site/trunk/book/fr/referencing/CoordinateOperations.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/book/fr/referencing/CoordinateOperations.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/book/fr/referencing/CoordinateOperations.html [UTF-8] (original)
+++ sis/site/trunk/book/fr/referencing/CoordinateOperations.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -63,7 +63,7 @@
         est d’utiliser la classe de commodité <code>org.apache.sis.referencing.CRS</code>:
       </p>
 
-<pre><code>CoordinateOperation cop = CRS.findOperation(sourceCRS, targetCRS, areaOfInterest);</code></pre>
+<pre><code>CoordinateOperation cop = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, areaOfInterest);</code></pre>
 
       <p>
         Parmi les information fournies par l’objet <code>CoordinateOperation</code> obtenu, on note en particulier:
@@ -134,7 +134,7 @@ public class MyApp {
     public static void main(String[] args) throws FactoryException, TransformException {
         CoordinateReferenceSystem sourceCRS = CommonCRS.WGS84.geographic();
         CoordinateReferenceSystem targetCRS = CommonCRS.WGS84.UTM(40, 14);  // Obtient la zone valide pour 14°E.
-        CoordinateOperation operation = CRS.findOperation(sourceCRS, targetCRS, null);
+        CoordinateOperation operation = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, null);
 
         // Les lignes précédentes sont coûteuses et ne devraient être exécutées qu’une seule fois avant
         // de transformer plusieurs points.  Dans cet exemple, l’opération que nous obtenons est valide

Modified: sis/site/trunk/content/book/en/developer-guide.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/book/en/developer-guide.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/content/book/en/developer-guide.html [UTF-8] (original)
+++ sis/site/trunk/content/book/en/developer-guide.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -681,25 +681,26 @@ However such instantiations should be do
 <p>
 The elements defined in a computer language, such as classes and methods in Java or elements in an <abbr>XML</abbr> document,
 appear in monospaced font.
-In order to facilitate an understanding of the relationships between Apache <abbr title="Spatial Information System">SIS</abbr> and the standards, these elements are also represented using the following colour codes:
+In order to facilitate an understanding of the relationships between Apache <abbr title="Spatial Information System">SIS</abbr> and the standards,
+these elements are also represented using the following colour codes:
 </p>
 <ul>
 <li>
-Elements defined in the <abbr title="Open Geospatial Consortium">OGC</abbr> standard
-or the <abbr title="International Organization for Standardization">ISO</abbr> standard appear in blue.
+Elements in blue are defined in an <abbr title="Open Geospatial Consortium">OGC</abbr> standard
+or an <abbr title="International Organization for Standardization">ISO</abbr> standard.
 Example: <code class="OGC">CD_Ellipsoid</code>.
 </li>
 <li>
-Elements defined in GeoAPI appear in green.
+Elements in green are defined in GeoAPI.
 Example: <code class="GeoAPI">Ellipsoid</code>.
 </li>
 <li>
-Elements defined in Apache <abbr title="Spatial Information System">SIS</abbr> appear in brown.
+Elements in brown are defined in Apache <abbr title="Spatial Information System">SIS</abbr>.
 Example: <code class="SIS">DefaultEllipsoid</code>.
 </li>
 <li>
-Other elements, such as those in standard Java, are left in black.
-Example: <code>String</code>.
+Elements left in black are either defined elsewhere (example: <code>String</code>),
+or there is simply no emphasis on that element for the discussion.
 </li>
 </ul>
 <p>
@@ -781,13 +782,13 @@ under the <code class="OGC">identificati
 following code read a metadata file from a Landsat-8 image and prints the declared geographic bounding box:
 </p>
 
-<pre><code><b>try</b> (<code class="SIS">DataStore</code> ds = DataStores.open(<b>new</b> File(<i>"LC81230522014071LGN00_MTL.txt"</i>))) {
-    <code class="GeoAPI">Metadata</code> md = ds.getMetadata();
+<pre><code><b>try</b> (<code class="SIS">DataStore</code> ds = <code class="SIS">DataStores</code>.open(<b>new</b> File(<i>"LC81230522014071LGN00_MTL.txt"</i>))) {
+    <code class="GeoAPI">Metadata</code> md = ds.<code class="SIS">getMetadata()</code>;
 
-    <code class="comment">// In order to make this example simpler, null values and empty collection checks are omited.
-</code>    <code class="GeoAPI">Identification</code>   idInfo = md    .getIdentificationInfo().iterator().next();
-    <code class="GeoAPI">Extent</code>           extent = idInfo.getExtents()           .iterator().next();
-    <code class="GeoAPI">GeographicExtent</code> bbox   = extent.getGeographicElements().iterator().next();
+    <code class="comment">// In order to make this example simpler, null values and empty collection checks are omited.</code>
+    <code class="GeoAPI">Identification</code>   idInfo = md    .<code class="GeoAPI">getIdentificationInfo()</code>.iterator().next();
+    <code class="GeoAPI">Extent</code>           extent = idInfo.<code class="GeoAPI">getExtents()</code>           .iterator().next();
+    <code class="GeoAPI">GeographicExtent</code> bbox   = extent.<code class="GeoAPI">getGeographicElements()</code>.iterator().next();
 
     System.out.println(<i>"The geographic bounding box is:"</i>);
     System.out.println(bbox);
@@ -887,12 +888,12 @@ Sometime the element to search is known
 In such cases, one can view the metadata as a <code>java.util.Map</code> like below:
 </p>
 
-<pre><code>Map&lt;String,Object&gt; elements = MetadataStandard.ISO_19115.asValueMap(
-        metadata,                           <code class="comment">// Any instance from the org.opengis.metadata package or a sub-package.
-</code>        <b>null</b>,                               <code class="comment">// Used for resolving ambiguities. We can ignore for this example.
-</code>        KeyNamePolicy.JAVABEANS_PROPERTY,   <code class="comment">// Keys in the map will be getter method names without "get" prefix.
-</code>        ValueExistencePolicy.NON_EMPTY);    <code class="comment">// Entries with null or empty values will be omitted.
-</code><code class="comment">/*
+<pre><code>Map&lt;String,Object&gt; elements = <code class="SIS">MetadataStandard</code>.ISO_19115.<code class="SIS">asValueMap</code>(
+        metadata,                           <code class="comment">// Any instance from the org.opengis.metadata package or a sub-package.</code>
+        <b>null</b>,                               <code class="comment">// Used for resolving ambiguities. We can ignore for this example.</code>
+        <code class="SIS">KeyNamePolicy</code>.<code class="SIS">JAVABEANS_PROPERTY</code>,   <code class="comment">// Keys in the map will be getter method names without "get" prefix.</code>
+        <code class="SIS">ValueExistencePolicy</code>.<code class="SIS">NON_EMPTY</code>);    <code class="comment">// Entries with null or empty values will be omitted.</code>
+<code class="comment">/*
  * Print the names of all root metadata elements having a value.
  * This loop does not iterate recursively in children.
  */</code>
@@ -1389,10 +1390,10 @@ but many ellipsoid definitions provide t
 </p>
 
 <pre><code>Unit&lt;Length&gt; units = ellipsoid.<code class="GeoAPI">getAxisUnit()</code>;
-<b>double</b> semiMajor   = ellipsoid.<code class="GeoAPI">getSemiMajorAxis()</code>;          <code class="comment">// In units of measurement given above.
-</code><b>double</b> semiMinor   = ellipsoid.<code class="GeoAPI">getSemiMinorAxis()</code>;          <code class="comment">// In units of measurement given above.
-</code><b>double</b> ivf         = ellipsoid.<code class="GeoAPI">getInverseFlattening()</code>;      <code class="comment">// = semiMajor / (semiMajor - semiMinor).
-</code></code></pre>
+<b>double</b> semiMajor   = ellipsoid.<code class="GeoAPI">getSemiMajorAxis()</code>;          <code class="comment">// In units of measurement given above.</code>
+<b>double</b> semiMinor   = ellipsoid.<code class="GeoAPI">getSemiMinorAxis()</code>;          <code class="comment">// In units of measurement given above.</code>
+<b>double</b> ivf         = ellipsoid.<code class="GeoAPI">getInverseFlattening()</code>;      <code class="comment">// = semiMajor / (semiMajor - semiMinor).</code>
+</code></pre>
 
 
 <h3 id="GeodeticDatum"><span class="section-number">5.1.2.</span> Geodetic datum</h3>
@@ -1459,14 +1460,14 @@ Axes are numbered from 0 to <code>cs.get
 </p>
 
 <pre><code><code class="GeoAPI">CoordinateSystem</code> cs = crs.getCoordinateSystem();
-<code class="GeoAPI">CoordinateSystemAxis</code> secondAxis = cs.getAxis(1);                 <code class="comment">// For a geographic CRS, this is usually geodetic longitude.
-</code>String        abbreviation = secondAxis.getAbbreviation();       <code class="comment">// For a longitude axis, this is usually "λ", "L" or "lon".
-</code><code class="GeoAPI">AxisDirection</code> direction    = secondAxis.getDirection();          <code class="comment">// For a longitude axis, this is usually EAST. Another occasional value is WEST.
-</code>Unit&lt;?&gt;       units        = secondAxis.getUnit();               <code class="comment">// For a longitude axis, this is usually Units.DEGREE.
-</code><b>double</b>        minimum      = secondAxis.getMinimumValue();       <code class="comment">// For a longitude axis, this is usually −180°. Another common value is 0°.
-</code><b>double</b>        maximum      = secondAxis.getMaximumValue();       <code class="comment">// For a longitude axis, this is usually +180°. Another common value is 360°.
-</code><code class="GeoAPI">RangeMeaning</code>  atEnds       = secondAxis.getRangeMeaning();       <code class="comment">// For a longitude axis, this is WRAPAROUND.
-</code></code></pre>
+<code class="GeoAPI">CoordinateSystemAxis</code> secondAxis = cs.getAxis(1);                 <code class="comment">// For a geographic CRS, this is usually geodetic longitude.</code>
+String        abbreviation = secondAxis.getAbbreviation();       <code class="comment">// For a longitude axis, this is usually "λ", "L" or "lon".</code>
+<code class="GeoAPI">AxisDirection</code> direction    = secondAxis.getDirection();          <code class="comment">// For a longitude axis, this is usually EAST. Another occasional value is WEST.</code>
+Unit&lt;?&gt;       units        = secondAxis.getUnit();               <code class="comment">// For a longitude axis, this is usually Units.DEGREE.</code>
+<b>double</b>        minimum      = secondAxis.getMinimumValue();       <code class="comment">// For a longitude axis, this is usually −180°. Another common value is 0°.</code>
+<b>double</b>        maximum      = secondAxis.getMaximumValue();       <code class="comment">// For a longitude axis, this is usually +180°. Another common value is 360°.</code>
+<code class="GeoAPI">RangeMeaning</code>  atEnds       = secondAxis.getRangeMeaning();       <code class="comment">// For a longitude axis, this is WRAPAROUND.</code>
+</code></pre>
 <p>
 
 In addition to axis definitions, another important coordinate system characteristic is their type
@@ -1505,8 +1506,8 @@ But if (<var>x</var>, <var>y</var>) axis
 then <abbr>CRS</abbr> forced to <cite>longitude first</cite> axis order can be created by a call to the following method:
 </p>
 
-<pre><code><code class="GeoAPI">CoordinateReferenceSystem</code> crs = …;               <code class="comment">// CRS obtained by any means.
-</code>crs = AbstractCRS.castOrCopy(crs).forConvention(AxesConvention.RIGHT_HANDED)</code></pre>
+<pre><code><code class="GeoAPI">CoordinateReferenceSystem</code> crs = …;               <code class="comment">// CRS obtained by any means.</code>
+crs = <code class="SIS">AbstractCRS</code>.<code class="SIS">castOrCopy</code>(crs).<code class="SIS">forConvention</code>(<code class="SIS">AxesConvention</code>.<code class="SIS">RIGHT_HANDED</code>)</code></pre>
 
 <p>
 Among the legacy <abbr>OGC</abbr> standards that used the non-conform axis order,
@@ -1609,7 +1610,7 @@ The easiest way to obtain a coordinate o
 is to use the <code class="SIS">org.apache.sis.referencing.CRS</code> convenience class:
 </p>
 
-<pre><code><code class="GeoAPI">CoordinateOperation</code> cop = CRS.findOperation(sourceCRS, targetCRS, areaOfInterest);</code></pre>
+<pre><code><code class="GeoAPI">CoordinateOperation</code> cop = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, areaOfInterest);</code></pre>
 
 <p>
 Among the information provided by <code class="GeoAPI">CoordinateOperation</code> object, the following are of special interest:
@@ -1660,7 +1661,7 @@ The “<a href="#CoordinateOperationStep
 <p>
 The following Java code performs a map projection from geographic coordinates on the <cite>World Geodetic System 1984</cite> (<abbr title="World Geodetic System 1984">WGS84</abbr>) datum
 coordinates in the <cite>WGS 84 / UTM zone 33N</cite> coordinate reference system.
-In order to make the example a little bit simpler, this code uses predefined constants given by the <code>CommonCRS</code> convenience class.
+In order to make the example a little bit simpler, this code uses predefined constants given by the <code class="SIS">CommonCRS</code> convenience class.
 But more advanced applications will typically use <abbr>EPSG</abbr> codes instead.
 Note that all geographic coordinates below express latitude before longitude.
 </p>
@@ -1671,21 +1672,21 @@ Note that all geographic coordinates bel
 <b>import</b> org.opengis.referencing.operation.<code class="GeoAPI">TransformException</code>;
 <b>import</b> org.opengis.util.<code class="GeoAPI">FactoryException</code>;
 <b>import</b> org.apache.sis.referencing.CRS;
-<b>import</b> org.apache.sis.referencing.CommonCRS;
-<b>import</b> org.apache.sis.geometry.DirectPosition2D;
+<b>import</b> org.apache.sis.referencing.<code class="SIS">CommonCRS</code>;
+<b>import</b> org.apache.sis.geometry.<code class="SIS">DirectPosition2D</code>;
 
 <b>public</b> <b>class</b> MyApp {
     <b>public</b> <b>static</b> <b>void</b> main(String[] args) <b>throws</b> <code class="GeoAPI">FactoryException</code>, <code class="GeoAPI">TransformException</code> {
-        <code class="GeoAPI">CoordinateReferenceSystem</code> sourceCRS = CommonCRS.WGS84.geographic();
-        <code class="GeoAPI">CoordinateReferenceSystem</code> targetCRS = CommonCRS.WGS84.UTM(40, 14);  <code class="comment">// Get whatever zone is valid for 14°E.
-</code>        <code class="GeoAPI">CoordinateOperation</code> operation = CRS.findOperation(sourceCRS, targetCRS, <b>null</b>);
-
-        <code class="comment">// The above lines are costly and should be performed only once before to project many points.
-</code>        <code class="comment">// In this example, the operation that we got is valid for coordinates in geographic area from
-</code>        <code class="comment">// 12°E to 18°E (UTM zone 33) and 0°N to 84°N.
-</code>
-        <code class="GeoAPI">DirectPosition</code> ptSrc = <b>new</b> DirectPosition2D(40, 14);           <code class="comment">// 40°N 14°E
-</code>        <code class="GeoAPI">DirectPosition</code> ptDst = operation.getMathTransform().transform(ptSrc, <b>null</b>);
+        <code class="GeoAPI">CoordinateReferenceSystem</code> sourceCRS = <code class="SIS">CommonCRS</code>.WGS84.geographic();
+        <code class="GeoAPI">CoordinateReferenceSystem</code> targetCRS = <code class="SIS">CommonCRS</code>.WGS84.UTM(40, 14);  <code class="comment">// Get whatever zone is valid for 14°E.</code>
+        <code class="GeoAPI">CoordinateOperation</code> operation = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, <b>null</b>);
+
+        <code class="comment">// The above lines are costly and should be performed only once before to project many points.</code>
+        <code class="comment">// In this example, the operation that we got is valid for coordinates in geographic area from</code>
+        <code class="comment">// 12°E to 18°E (UTM zone 33) and 0°N to 84°N.</code>
+
+        <code class="GeoAPI">DirectPosition</code> ptSrc = <b>new</b> <code class="SIS">DirectPosition2D</code>(40, 14);           <code class="comment">// 40°N 14°E</code>
+        <code class="GeoAPI">DirectPosition</code> ptDst = operation.getMathTransform().transform(ptSrc, <b>null</b>);
 
         System.out.println(<i>"Source: "</i> + ptSrc);
         System.out.println(<i>"Target: "</i> + ptDst);
@@ -1722,7 +1723,7 @@ The formula below represents the map pro
 </div>
 <div style="min-width:500px; padding-left:60px">
 <div class="caption">Java code</div>
-<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> DirectPosition2D(<var>φ</var>, <var>λ</var>);
+<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> <code class="SIS">DirectPosition2D</code>(<var>φ</var>, <var>λ</var>);
 <code class="GeoAPI">DirectPosition</code> projected = <var><b>P</b></var>.transform(geographic, <b>null</b>);
 <b>double</b> <var>x</var> = projected.getOrdinate(0);
 <b>double</b> <var>y</var> = projected.getOrdinate(1);</code></pre>
@@ -1755,7 +1756,7 @@ The formula below represents the map pro
 </div>
 <div style="min-width:500px; padding-left:60px">
 <div class="caption">Java code</div>
-<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> DirectPosition2D(<var>φ</var>, <var>λ</var>);
+<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> <code class="SIS">DirectPosition2D</code>(<var>φ</var>, <var>λ</var>);
 <code class="GeoAPI">Matrix</code> jacobian = <var><b>P</b></var>.derivative(geographic);
 <b>double</b> dx_dλ = jacobian.getElement(0,1);
 <b>double</b> dy_dφ = jacobian.getElement(1,0);</code></pre>
@@ -1909,10 +1910,10 @@ Continuing…
 <span style="color: red">TODO</span>
 Example:</p>
 
-<pre><code><code class="SIS">AbstractMathTransform</code> projection = ...;         <code class="comment">// An Apache SIS map projection.
-</code><b>double</b>[] sourcePoint = {longitude, latitude};   <code class="comment">// The geographic coordinate to project.
-</code><b>double</b>[] targetPoint = <b>new</b> <b>double</b>[2];           <code class="comment">// Where to store the projection result.
-</code><code class="GeoAPI">Matrix</code>   derivative  = projection.<code class="SIS">transform</code>(sourcePoint, 0, targetPoint, 0, <b>true</b>);</code></pre>
+<pre><code><code class="SIS">AbstractMathTransform</code> projection = ...;         <code class="comment">// An Apache SIS map projection.</code>
+<b>double</b>[] sourcePoint = {longitude, latitude};   <code class="comment">// The geographic coordinate to project.</code>
+<b>double</b>[] targetPoint = <b>new</b> <b>double</b>[2];           <code class="comment">// Where to store the projection result.</code>
+<code class="GeoAPI">Matrix</code>   derivative  = projection.<code class="SIS">transform</code>(sourcePoint, 0, targetPoint, 0, <b>true</b>);</code></pre>
 
 <p>
 <span style="color: red">TODO</span>
@@ -2608,12 +2609,12 @@ have created their own interface for per
 Details vary, but such interfaces typically look like below:
 </p>
 
-<pre><code><b>interface</b> ObjectConverter&lt;S,T&gt; {   <code class="comment">// Some projects use only "Converter" as interface name.
-</code>    T apply(S object);             <code class="comment">// Another method name commonly found in other projects is "convert".
-</code>}</code></pre>
+<pre><code><b>interface</b> <code class="SIS">ObjectConverter</code>&lt;S,T&gt; {   <code class="comment">// Some projects use only "Converter" as interface name.</code>
+    T apply(S object);             <code class="comment">// Another method name commonly found in other projects is "convert".</code>
+}</code></pre>
 
 <p>
-Like other projects, Apache <abbr title="Spatial Information System">SIS</abbr> also defines its own <code>ObjectConverter</code> interface.
+Like other projects, Apache <abbr title="Spatial Information System">SIS</abbr> also defines its own <code class="SIS">ObjectConverter</code> interface.
 The main difference between <abbr>SIS</abbr> converter interface and the interfaces found in other projects
 is that <abbr>SIS</abbr> converters provide some information about their mathematical properties.
 An Apache <abbr>SIS</abbr> converter can have zero, one or many of the following properties:
@@ -2809,8 +2810,8 @@ Thus, instead of the loop on the left be
 <pre style="margin-top: 6pt"><code><b>for</b> (<b>int</b> i=0; i&lt;string.length(); i++) {
     <b>char</b> c = string.charAt(i);
     <b>if</b> (Character.isWhitespace(c)) {
-        <code class="comment">// A blank space was found.
-</code>    }
+        <code class="comment">// A blank space was found.</code>
+    }
 }</code></pre>
 </div>
 <div>
@@ -2818,8 +2819,8 @@ Thus, instead of the loop on the left be
 <pre style="margin-top: 6pt"><code><b>for</b> (<b>int</b> i=0; i&lt;string.length();) {
     <b>int</b> c = string.codePointAt(i);
     <b>if</b> (Character.isWhitespace(c)) {
-        <code class="comment">// A blank space was found.
-</code>    }
+        <code class="comment">// A blank space was found.</code>
+    }
     i += Character.charCount(c);
 }</code></pre>
 </div>
@@ -3301,8 +3302,8 @@ creates new instances if the name provid
 </p>
 
 <pre><code><code class="GeoAPI">MediumName</code> cdRom  = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">CD_ROM;</code>
-<code class="GeoAPI">MediumName</code> usbKey = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>); <code class="comment">// There is no constraint on this value.
-</code><b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">CD_ROM</code>"</i>)  == cdRom  : <i>"valueOf must return existing constants."</i>;
+<code class="GeoAPI">MediumName</code> usbKey = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>); <code class="comment">// There is no constraint on this value.</code>
+<b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">CD_ROM</code>"</i>)  == cdRom  : <i>"valueOf must return existing constants."</i>;
 <b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>) == usbKey : <i>"valueOf must cache the previously requested values."</i>;</code></pre>
 </section>
 
@@ -3578,8 +3579,8 @@ as in the following example:
 
     @Test
     <b>public</b> <b>void</b> testMyMetadata() {
-        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Create an object here.
-</code>        <code class="GeoAPI">Validators</code>.<code class="GeoAPI">validate</code>(myObject);
+        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Create an object here.</code>
+        <code class="GeoAPI">Validators</code>.<code class="GeoAPI">validate</code>(myObject);
     }
 }</code></pre>
 
@@ -3603,8 +3604,8 @@ This approach requires the creation of a
 
     @Test
     <b>public</b> <b>void</b> testMyMetadata() {
-        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Create an object here.
-</code>        validators.<code class="GeoAPI">validate</code>(myObject);
+        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Create an object here.</code>
+        validators.<code class="GeoAPI">validate</code>(myObject);
     }
 }</code></pre>
 
@@ -3649,8 +3650,8 @@ However, this example adds a supplementa
     @Test
     @Override
     <b>public</b> <b>void</b> testLambertAzimuthalEqualArea() <b>throws</b> <code class="GeoAPI">FactoryException</code>, <code class="GeoAPI">TransformException</code> {
-        <code class="GeoAPI">tolerance</code> = 0.1;                    <code class="comment">// 10 cm tolerance.
-</code>        <b>super</b>.<code class="GeoAPI">testLambertAzimuthalEqualArea()</code>;
+        <code class="GeoAPI">tolerance</code> = 0.1;                    <code class="comment">// 10 cm tolerance.</code>
+        <b>super</b>.<code class="GeoAPI">testLambertAzimuthalEqualArea()</code>;
     }
 
     <code class="comment">/**
@@ -4010,11 +4011,11 @@ But in the special case where the transf
 in particular Java2D. The following Java code can be used in situations where the Java2D object is desired:
 </p>
 
-<pre><code><code class="GeoAPI">MathTransform</code> mt = ...;    <code class="comment">// Any math transform created by Apache SIS.
-</code><b>if</b> (mt <b>instanceof</b> AffineTransform) {
+<pre><code><code class="GeoAPI">MathTransform</code> mt = ...;    <code class="comment">// Any math transform created by Apache SIS.</code>
+<b>if</b> (mt <b>instanceof</b> AffineTransform) {
     AffineTransform at = (AffineTransform) mt;
-    <code class="comment">// Use Java2D API from here.
-</code>}</code></pre>
+    <code class="comment">// Use Java2D API from here.</code>
+}</code></pre>
 
 <p>
 Apache <abbr>SIS</abbr> uses Java2D on a <em>best effort</em> basis only.

Modified: sis/site/trunk/content/book/fr/developer-guide.html
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/book/fr/developer-guide.html?rev=1815696&r1=1815695&r2=1815696&view=diff
==============================================================================
--- sis/site/trunk/content/book/fr/developer-guide.html [UTF-8] (original)
+++ sis/site/trunk/content/book/fr/developer-guide.html [UTF-8] Sat Nov 18 21:22:29 2017
@@ -721,21 +721,21 @@ ces éléments sont en outre représent�
 </p>
 <ul>
 <li>
-Les éléments définis dans un standard de l’<abbr title="Open Geospatial Consortium">OGC</abbr>
-ou de l’<abbr title="International Organization for Standardization">ISO</abbr> apparaissent en bleu.
+Les éléments en bleu sont définis dans un standard de l’<abbr title="Open Geospatial Consortium">OGC</abbr>
+ou de l’<abbr title="International Organization for Standardization">ISO</abbr>.
 Exemple: <code class="OGC">CD_Ellipsoid</code>.
 </li>
 <li>
-Les éléments définis dans GeoAPI apparaissent en vert.
+Les éléments en vert sont définis dans GeoAPI.
 Exemple: <code class="GeoAPI">Ellipsoid</code>.
 </li>
 <li>
-Les éléments définis dans Apache <abbr title="Spatial Information System">SIS</abbr> apparaissent en brun.
+Les éléments en brun sont définis dans Apache <abbr title="Spatial Information System">SIS</abbr>.
 Exemple: <code class="SIS">DefaultEllipsoid</code>.
 </li>
 <li>
-Les autres éléments, notamment ceux du Java standard, sont laissés en noir.
-Exemple: <code>String</code>.
+Les éléments laissés en noir sont soient définis ailleurs (exemple: <code>String</code>),
+ou ne font pas l’objet d’une emphase particulière pour la discussion.
 </li>
 </ul>
 <p>
@@ -820,13 +820,13 @@ sous-noeud <code class="OGC">geographicE
 le code suivant lit un fichier de méta-données d’une image Landsat-8 et affiche les limites géographiques qui y sont déclarées:
 </p>
 
-<pre><code><b>try</b> (<code class="SIS">DataStore</code> ds = DataStores.open(<b>new</b> File(<i>"LC81230522014071LGN00_MTL.txt"</i>))) {
-    <code class="GeoAPI">Metadata</code> md = ds.getMetadata();
+<pre><code><b>try</b> (<code class="SIS">DataStore</code> ds = <code class="SIS">DataStores</code>.open(<b>new</b> File(<i>"LC81230522014071LGN00_MTL.txt"</i>))) {
+    <code class="GeoAPI">Metadata</code> md = ds.<code class="SIS">getMetadata()</code>;
 
-    <code class="comment">// Afin de simplifier cet exemple, nous omettons les vérifications de valeurs nulles ou de collections vides.
-</code>    <code class="GeoAPI">Identification</code>   idInfo = md    .getIdentificationInfo().iterator().next();
-    <code class="GeoAPI">Extent</code>           extent = idInfo.getExtents()           .iterator().next();
-    <code class="GeoAPI">GeographicExtent</code> bbox   = extent.getGeographicElements().iterator().next();
+    <code class="comment">// Afin de simplifier cet exemple, nous omettons les vérifications de valeurs nulles ou de collections vides.</code>
+    <code class="GeoAPI">Identification</code>   idInfo = md    .<code class="GeoAPI">getIdentificationInfo()</code>.iterator().next();
+    <code class="GeoAPI">Extent</code>           extent = idInfo.<code class="GeoAPI">getExtents()</code>           .iterator().next();
+    <code class="GeoAPI">GeographicExtent</code> bbox   = extent.<code class="GeoAPI">getGeographicElements()</code>.iterator().next();
 
     System.out.println(<i>"La région géographique des données est:"</i>);
     System.out.println(bbox);
@@ -932,12 +932,12 @@ Il arrive que l’on veuille plutôt acc
 Dans ces cas, on peut utiliser une vue sous forme de <code>java.util.Map</code> comme dans l’exemple suivant:
 </p>
 
-<pre><code>Map&lt;String,Object&gt; elements = MetadataStandard.ISO_19115.asValueMap(
-        metadata,                           <code class="comment">// N’importe quelle instance du paquet org.opengis.metadata ou d’un sous-paquet.
-</code>        <b>null</b>,                               <code class="comment">// Utilisé pour résoudre des ambiguïtés. Peut être ignoré pour cet exemple.
-</code>        KeyNamePolicy.JAVABEANS_PROPERTY,   <code class="comment">// Les clés seront les noms des méthodes mais sans le prefix « get ».
-</code>        ValueExistencePolicy.NON_EMPTY);    <code class="comment">// Les entrés dont la valeur est nulle ou vide seront omises.
-</code><code class="comment">/*
+<pre><code>Map&lt;String,Object&gt; elements = <code class="SIS">MetadataStandard</code>.ISO_19115.<code class="SIS">asValueMap</code>(
+        metadata,                           <code class="comment">// N’importe quelle instance du paquet org.opengis.metadata ou d’un sous-paquet.</code>
+        <b>null</b>,                               <code class="comment">// Utilisé pour résoudre des ambiguïtés. Peut être ignoré pour cet exemple.</code>
+        <code class="SIS">KeyNamePolicy</code>.<code class="SIS">JAVABEANS_PROPERTY</code>,   <code class="comment">// Les clés seront les noms des méthodes mais sans le prefix « get ».</code>
+        <code class="SIS">ValueExistencePolicy</code>.<code class="SIS">NON_EMPTY</code>);    <code class="comment">// Les entrés dont la valeur est nulle ou vide seront omises.</code>
+<code class="comment">/*
  * Affiche les noms de tous les éléments à la racine de la méta-données qui ont une valeur.
  * Cette bouche ne va pas descendre dans les enfants (pas de récursivité).
  */</code>
@@ -1438,10 +1438,10 @@ mais plusieurs définitions d’ellipso�
 </p>
 
 <pre><code>Unit&lt;Length&gt; units = ellipsoid.<code class="GeoAPI">getAxisUnit()</code>;
-<b>double</b> semiMajor   = ellipsoid.<code class="GeoAPI">getSemiMajorAxis()</code>;          <code class="comment">// In units of measurement given above.
-</code><b>double</b> semiMinor   = ellipsoid.<code class="GeoAPI">getSemiMinorAxis()</code>;          <code class="comment">// In units of measurement given above.
-</code><b>double</b> ivf         = ellipsoid.<code class="GeoAPI">getInverseFlattening()</code>;      <code class="comment">// = semiMajor / (semiMajor - semiMinor).
-</code></code></pre>
+<b>double</b> semiMajor   = ellipsoid.<code class="GeoAPI">getSemiMajorAxis()</code>;          <code class="comment">// In units of measurement given above.</code>
+<b>double</b> semiMinor   = ellipsoid.<code class="GeoAPI">getSemiMinorAxis()</code>;          <code class="comment">// In units of measurement given above.</code>
+<b>double</b> ivf         = ellipsoid.<code class="GeoAPI">getInverseFlattening()</code>;      <code class="comment">// = semiMajor / (semiMajor - semiMinor).</code>
+</code></pre>
 
 
 <h3 id="GeodeticDatum"><span class="section-number">5.1.2.</span> Référentiel géodésique</h3>
@@ -1510,14 +1510,14 @@ Les axes sont numérotés de 0 à <code>
 </p>
 
 <pre><code><code class="GeoAPI">CoordinateSystem</code> cs = crs.getCoordinateSystem();
-<code class="GeoAPI">CoordinateSystemAxis</code> secondAxe = cs.getAxis(1);                 <code class="comment">// Pour un système géographique, c’est habituellement la longitude géodétique.
-</code>String        abbreviation = secondAxe.getAbbreviation();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement "λ", "L" ou "lon".
-</code><code class="GeoAPI">AxisDirection</code> direction    = secondAxe.getDirection();          <code class="comment">// Pour l’axe des longitudes, c’est habituellement EAST. On trouve aussi parfois WEST.
-</code>Unit&lt;?&gt;       unités       = secondAxe.getUnit();               <code class="comment">// Pour l’axe des longitudes, c’est habituellement Units.DEGREE.
-</code><b>double</b>        minimum      = secondAxe.getMinimumValue();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement −180°. Une autre valeur courante est 0°.
-</code><b>double</b>        maximum      = secondAxe.getMaximumValue();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement +180°. Une autre valeur courante est 360°.
-</code><code class="GeoAPI">RangeMeaning</code>  auxBouts     = secondAxe.getRangeMeaning();       <code class="comment">// Pour l’axe des longitudes, c’est WRAPAROUND.
-</code></code></pre>
+<code class="GeoAPI">CoordinateSystemAxis</code> secondAxe = cs.getAxis(1);                 <code class="comment">// Pour un système géographique, c’est habituellement la longitude géodétique.</code>
+String        abbreviation = secondAxe.getAbbreviation();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement "λ", "L" ou "lon".</code>
+<code class="GeoAPI">AxisDirection</code> direction    = secondAxe.getDirection();          <code class="comment">// Pour l’axe des longitudes, c’est habituellement EAST. On trouve aussi parfois WEST.</code>
+Unit&lt;?&gt;       unités       = secondAxe.getUnit();               <code class="comment">// Pour l’axe des longitudes, c’est habituellement Units.DEGREE.</code>
+<b>double</b>        minimum      = secondAxe.getMinimumValue();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement −180°. Une autre valeur courante est 0°.</code>
+<b>double</b>        maximum      = secondAxe.getMaximumValue();       <code class="comment">// Pour l’axe des longitudes, c’est habituellement +180°. Une autre valeur courante est 360°.</code>
+<code class="GeoAPI">RangeMeaning</code>  auxBouts     = secondAxe.getRangeMeaning();       <code class="comment">// Pour l’axe des longitudes, c’est WRAPAROUND.</code>
+</code></pre>
 <p>
 En plus de la définition des axes, une autre caractéristique importante des systèmes de coordonnées est leur type
 (<code class="GeoAPI">CartesianCS</code>, <code class="GeoAPI">SphericalCS</code>, <i>etc.</i>). Ce type implique un ensemble de règles mathématiques
@@ -1559,8 +1559,8 @@ Mais si l’ordre (<var>x</var>, <var>y<
 alors les <abbr>CRS</abbr> peuvent être modifiés de manière à avoir la longitude en premier avec un appel à la méthode suivante:
 </p>
 
-<pre><code><code class="GeoAPI">CoordinateReferenceSystem</code> crs = …;  <code class="comment">// CRS obtenu de n’importe quelle façon.
-</code>crs = AbstractCRS.castOrCopy(crs).forConvention(AxesConvention.RIGHT_HANDED)</code></pre>
+<pre><code><code class="GeoAPI">CoordinateReferenceSystem</code> crs = …;  <code class="comment">// CRS obtenu de n’importe quelle façon.</code>
+crs = <code class="SIS">AbstractCRS</code>.<code class="SIS">castOrCopy</code>(crs).<code class="SIS">forConvention</code>(<code class="SIS">AxesConvention</code>.<code class="SIS">RIGHT_HANDED</code>)</code></pre>
 
 <p>
 Parmi les anciens standards de l’<abbr>OGC</abbr> qui utilisaient un ordre des axes non-conforme,
@@ -1662,7 +1662,7 @@ La façon la plus facile d’obtenir une
 est d’utiliser la classe de commodité <code class="SIS">org.apache.sis.referencing.CRS</code>:
 </p>
 
-<pre><code><code class="GeoAPI">CoordinateOperation</code> cop = CRS.findOperation(sourceCRS, targetCRS, areaOfInterest);</code></pre>
+<pre><code><code class="GeoAPI">CoordinateOperation</code> cop = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, areaOfInterest);</code></pre>
 
 <p>
 Parmi les information fournies par l’objet <code class="GeoAPI">CoordinateOperation</code> obtenu, on note en particulier:
@@ -1715,7 +1715,7 @@ La section « <a href="#CoordinateOpera
 <p>
 Le code Java suivant effectue une projection cartographique à partir de coordonnées géographiques selon le référentiel
 <cite>World Geodetic System 1984</cite> (<abbr title="World Geodetic System 1984">WGS84</abbr>) vers des coordonnées selon le système <cite>WGS 84 / UTM zone 33N</cite>.
-Afin de rendre l’exemple un peu plus simple, ce code utilise des constantes pré-définies dans la classe de commodité <code>CommonCRS</code>.
+Afin de rendre l’exemple un peu plus simple, ce code utilise des constantes pré-définies dans la classe de commodité <code class="SIS">CommonCRS</code>.
 Mais des applications plus avancées voudront souvent utiliser des codes <abbr>EPSG</abbr> plutôt.
 Notons que toutes les coordonnées géographiques dans ce code ont la latitude avant la longitude.
 </p>
@@ -1726,21 +1726,21 @@ Notons que toutes les coordonnées géog
 <b>import</b> org.opengis.referencing.operation.<code class="GeoAPI">TransformException</code>;
 <b>import</b> org.opengis.util.<code class="GeoAPI">FactoryException</code>;
 <b>import</b> org.apache.sis.referencing.CRS;
-<b>import</b> org.apache.sis.referencing.CommonCRS;
-<b>import</b> org.apache.sis.geometry.DirectPosition2D;
+<b>import</b> org.apache.sis.referencing.<code class="SIS">CommonCRS</code>;
+<b>import</b> org.apache.sis.geometry.<code class="SIS">DirectPosition2D</code>;
 
 <b>public</b> <b>class</b> MyApp {
     <b>public</b> <b>static</b> <b>void</b> main(String[] args) <b>throws</b> <code class="GeoAPI">FactoryException</code>, <code class="GeoAPI">TransformException</code> {
-        <code class="GeoAPI">CoordinateReferenceSystem</code> sourceCRS = CommonCRS.WGS84.geographic();
-        <code class="GeoAPI">CoordinateReferenceSystem</code> targetCRS = CommonCRS.WGS84.UTM(40, 14);  <code class="comment">// Obtient la zone valide pour 14°E.
-</code>        <code class="GeoAPI">CoordinateOperation</code> operation = CRS.findOperation(sourceCRS, targetCRS, <b>null</b>);
-
-        <code class="comment">// Les lignes précédentes sont coûteuses et ne devraient être exécutées qu’une seule fois avant
-</code>        <code class="comment">// de transformer plusieurs points.  Dans cet exemple, l’opération que nous obtenons est valide
-</code>        <code class="comment">// pour des coordonnées dans la région géographique allant de 12°E à 18°E (zone 33) et 0°N à 84°N.
-</code>
-        <code class="GeoAPI">DirectPosition</code> ptSrc = <b>new</b> DirectPosition2D(40, 14);           <code class="comment">// 40°N 14°E
-</code>        <code class="GeoAPI">DirectPosition</code> ptDst = operation.getMathTransform().transform(ptSrc, <b>null</b>);
+        <code class="GeoAPI">CoordinateReferenceSystem</code> sourceCRS = <code class="SIS">CommonCRS</code>.WGS84.geographic();
+        <code class="GeoAPI">CoordinateReferenceSystem</code> targetCRS = <code class="SIS">CommonCRS</code>.WGS84.UTM(40, 14);  <code class="comment">// Obtient la zone valide pour 14°E.</code>
+        <code class="GeoAPI">CoordinateOperation</code> operation = <code class="SIS">CRS.findOperation</code>(sourceCRS, targetCRS, <b>null</b>);
+
+        <code class="comment">// Les lignes précédentes sont coûteuses et ne devraient être exécutées qu’une seule fois avant</code>
+        <code class="comment">// de transformer plusieurs points.  Dans cet exemple, l’opération que nous obtenons est valide</code>
+        <code class="comment">// pour des coordonnées dans la région géographique allant de 12°E à 18°E (zone 33) et 0°N à 84°N.</code>
+
+        <code class="GeoAPI">DirectPosition</code> ptSrc = <b>new</b> <code class="SIS">DirectPosition2D</code>(40, 14);           <code class="comment">// 40°N 14°E</code>
+        <code class="GeoAPI">DirectPosition</code> ptDst = operation.getMathTransform().transform(ptSrc, <b>null</b>);
 
         System.out.println(<i>"Source: "</i> + ptSrc);
         System.out.println(<i>"Target: "</i> + ptDst);
@@ -1777,7 +1777,7 @@ sous forme d’une matrice colonne (la r
 </div>
 <div style="min-width:500px; padding-left:60px">
 <div class="caption">Code Java</div>
-<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> DirectPosition2D(<var>φ</var>, <var>λ</var>);
+<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> <code class="SIS">DirectPosition2D</code>(<var>φ</var>, <var>λ</var>);
 <code class="GeoAPI">DirectPosition</code> projected = <var><b>P</b></var>.transform(geographic, <b>null</b>);
 <b>double</b> <var>x</var> = projected.getOrdinate(0);
 <b>double</b> <var>y</var> = projected.getOrdinate(1);</code></pre>
@@ -1810,7 +1810,7 @@ sous forme d’une matrice colonne (la r
 </div>
 <div style="min-width:500px; padding-left:60px">
 <div class="caption">Code Java</div>
-<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> DirectPosition2D(<var>φ</var>, <var>λ</var>);
+<pre style="margin:0"><code><code class="GeoAPI">DirectPosition</code> geographic = <b>new</b> <code class="SIS">DirectPosition2D</code>(<var>φ</var>, <var>λ</var>);
 <code class="GeoAPI">Matrix</code> jacobian = <var><b>P</b></var>.derivative(geographic);
 <b>double</b> dx_dλ = jacobian.getElement(0,1);
 <b>double</b> dy_dφ = jacobian.getElement(1,0);</code></pre>
@@ -2056,10 +2056,10 @@ et en offrant une méthode qui permet de
 afin de permettre à <abbr>SIS</abbr> de réutiliser un maximum de termes communs.
 Exemple:</p>
 
-<pre><code><code class="SIS">AbstractMathTransform</code> projection = ...;         <code class="comment">// Une projection cartographique de Apache SIS.
-</code><b>double</b>[] sourcePoint = {longitude, latitude};   <code class="comment">// La coordonnée géographique que l’on veut projeter.
-</code><b>double</b>[] targetPoint = <b>new</b> <b>double</b>[2];           <code class="comment">// Là où on mémorisera le résultat de la projection.
-</code><code class="GeoAPI">Matrix</code>   derivative  = projection.<code class="SIS">transform</code>(sourcePoint, 0, targetPoint, 0, <b>true</b>);</code></pre>
+<pre><code><code class="SIS">AbstractMathTransform</code> projection = ...;         <code class="comment">// Une projection cartographique de Apache SIS.</code>
+<b>double</b>[] sourcePoint = {longitude, latitude};   <code class="comment">// La coordonnée géographique que l’on veut projeter.</code>
+<b>double</b>[] targetPoint = <b>new</b> <b>double</b>[2];           <code class="comment">// Là où on mémorisera le résultat de la projection.</code>
+<code class="GeoAPI">Matrix</code>   derivative  = projection.<code class="SIS">transform</code>(sourcePoint, 0, targetPoint, 0, <b>true</b>);</code></pre>
 
 <p>
 Si seule la matrice Jacobienne est désirée (sans la projection du point), alors la méthode
@@ -2542,12 +2542,12 @@ ont créé leur propres interfaces pour
 Les détails varient, mais ces interfaces ressemblent typiquement à l’interface suivante:
 </p>
 
-<pre><code><b>interface</b> ObjectConverter&lt;S,T&gt; {   <code class="comment">// Certains projets utilisent seulement "Converter" comme nom d’interface.
-</code>    T apply(S object);             <code class="comment">// Un autre nom de méthode souvent utilisé par les autres projets est "convert".
-</code>}</code></pre>
+<pre><code><b>interface</b> <code class="SIS">ObjectConverter</code>&lt;S,T&gt; {   <code class="comment">// Certains projets utilisent seulement "Converter" comme nom d’interface.</code>
+    T apply(S object);             <code class="comment">// Un autre nom de méthode souvent utilisé par les autres projets est "convert".</code>
+}</code></pre>
 
 <p>
-Comme d’autres projets, Apache <abbr title="Spatial Information System">SIS</abbr> définit sa propre interface <code>ObjectConverter</code>.
+Comme d’autres projets, Apache <abbr title="Spatial Information System">SIS</abbr> définit sa propre interface <code class="SIS">ObjectConverter</code>.
 La principale différence entre l’interface de <abbr>SIS</abbr> est celle que l’on retrouve dans d’autres projets
 est que <abbr>SIS</abbr> fournit des informations à propos de certaines propriétés mathématiques des convertisseurs.
 Un convertisseur de Apache <abbr>SIS</abbr> peut avoir aucune, une ou plusieurs des propriétés suivantes:
@@ -2751,8 +2751,8 @@ généralement utiliser la boucle de dro
 <pre style="margin-top: 6pt"><code><b>for</b> (<b>int</b> i=0; i&lt;string.length(); i++) {
     <b>char</b> c = string.charAt(i);
     <b>if</b> (Character.isWhitespace(c)) {
-        <code class="comment">// Un espace blanc a été trouvé.
-</code>    }
+        <code class="comment">// Un espace blanc a été trouvé.</code>
+    }
 }</code></pre>
 </div>
 <div>
@@ -2760,8 +2760,8 @@ généralement utiliser la boucle de dro
 <pre style="margin-top: 6pt"><code><b>for</b> (<b>int</b> i=0; i&lt;string.length();) {
     <b>int</b> c = string.codePointAt(i);
     <b>if</b> (Character.isWhitespace(c)) {
-        <code class="comment">// Un espace blanc a été trouvé.
-</code>    }
+        <code class="comment">// Un espace blanc a été trouvé.</code>
+    }
     i += Character.charCount(c);
 }</code></pre>
 </div>
@@ -3260,8 +3260,8 @@ contrairement à celle de <code>Enum</co
 </p>
 
 <pre><code><code class="GeoAPI">MediumName</code> cdRom  = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">CD_ROM;</code>
-<code class="GeoAPI">MediumName</code> usbKey = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>); <code class="comment">// Aucune constante n’existe pour cette valeur.
-</code><b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">CD_ROM</code>"</i>)  == cdRom  : <i>"valueOf doit retourner les constantes existantes."</i>;
+<code class="GeoAPI">MediumName</code> usbKey = <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>); <code class="comment">// Aucune constante n’existe pour cette valeur.</code>
+<b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">CD_ROM</code>"</i>)  == cdRom  : <i>"valueOf doit retourner les constantes existantes."</i>;
 <b>assert</b> <code class="GeoAPI">MediumName</code>.<code class="GeoAPI">valueOf</code>(<i>"<code class="GeoAPI">USB_KEY</code>"</i>) == usbKey : <i>"valueOf doit cacher les valeurs précédemment demandées."</i>;</code></pre>
 </section>
 
@@ -3543,8 +3543,8 @@ Cette règle et quelques autres peuvent
 
     @Test
     <b>public</b> <b>void</b> testMyMetadata() {
-        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Construisez un objet ici.
-</code>        <code class="GeoAPI">Validators</code>.<code class="GeoAPI">validate</code>(myObject);
+        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Construisez un objet ici.</code>
+        <code class="GeoAPI">Validators</code>.<code class="GeoAPI">validate</code>(myObject);
     }
 }</code></pre>
 
@@ -3569,8 +3569,8 @@ Cette approche nécessite de créer une
 
     @Test
     <b>public</b> <b>void</b> testMyMetadata() {
-        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Construisez un objet ici.
-</code>        validators.<code class="GeoAPI">validate</code>(myObject);
+        <code class="GeoAPI">Metadata</code> myObject = …; <code class="comment">// Construisez un objet ici.</code>
+        validators.<code class="GeoAPI">validate</code>(myObject);
     }
 }</code></pre>
 
@@ -3616,8 +3616,8 @@ qui sera exécutée après chacun des te
     @Test
     @Override
     <b>public</b> <b>void</b> testLambertAzimuthalEqualArea() <b>throws</b> <code class="GeoAPI">FactoryException</code>, <code class="GeoAPI">TransformException</code> {
-        <code class="GeoAPI">tolerance</code> = 0.1;                    <code class="comment">// Tolérance de 10 cm.
-</code>        <b>super</b>.<code class="GeoAPI">testLambertAzimuthalEqualArea()</code>;
+        <code class="GeoAPI">tolerance</code> = 0.1;                    <code class="comment">// Tolérance de 10 cm.</code>
+        <b>super</b>.<code class="GeoAPI">testLambertAzimuthalEqualArea()</code>;
     }
 
     <code class="comment">/**
@@ -3986,11 +3986,11 @@ une implémentation existante, surtout J
 Par exemple le code suivant peut être utilisé dans les situations où un objet Java2D est désiré:
 </p>
 
-<pre><code><code class="GeoAPI">MathTransform</code> mt = ...;    <code class="comment">// N’importe quelle instance créée par Apache SIS.
-</code><b>if</b> (mt <b>instanceof</b> AffineTransform) {
+<pre><code><code class="GeoAPI">MathTransform</code> mt = ...;    <code class="comment">// N’importe quelle instance créée par Apache SIS.</code>
+<b>if</b> (mt <b>instanceof</b> AffineTransform) {
     AffineTransform at = (AffineTransform) mt;
-    <code class="comment">// Utiliser l’API de Java2D API à partir d’ici.
-</code>}</code></pre>
+    <code class="comment">// Utiliser l’API de Java2D API à partir d’ici.</code>
+}</code></pre>
 
 <p>
 Toutefois <abbr>SIS</abbr> n’utilisera Java2D que sur une base opportuniste.



Mime
View raw message