You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2017/11/18 21:22:30 UTC
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...
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<String,Object> 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<String,Object> 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<Length> 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<?> 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<?> 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<S,T> { <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><S,T> { <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<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<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<String,Object> 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<String,Object> 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<Length> 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<?> 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<?> 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<S,T> { <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><S,T> { <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<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<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.