sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1816195 - in /sis/site/trunk/content: gdal.mdtext index.mdtext
Date Thu, 23 Nov 2017 23:15:55 GMT
Author: desruisseaux
Date: Thu Nov 23 23:15:55 2017
New Revision: 1816195

URL: http://svn.apache.org/viewvc?rev=1816195&view=rev
Log:
Update documentation about Proj.4 use.

Modified:
    sis/site/trunk/content/gdal.mdtext
    sis/site/trunk/content/index.mdtext

Modified: sis/site/trunk/content/gdal.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/gdal.mdtext?rev=1816195&r1=1816194&r2=1816195&view=diff
==============================================================================
--- sis/site/trunk/content/gdal.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/gdal.mdtext [UTF-8] Thu Nov 23 23:15:55 2017
@@ -19,9 +19,10 @@ Notice: Licensed to the Apache Software
 
 
 While Apache SIS provides its own map projection engine, some applications may want to also
use the Proj.4 library.
-It may be for using map projection methods not yet supported by Apache SIS, or for getting
the exact same numerical
-results than Proj.4. The two libraries can coexist and can be used through the same API,
-provided that following prerequisites are meet.
+One reason may be to use map projection methods not yet supported by Apache SIS,
+or for getting the exact same numerical results than Proj.4.
+The two libraries can coexist and can be used through the same API,
+provided that prerequisites are meet.
 
 [TOC]
 
@@ -53,8 +54,8 @@ For instantiating a coordinate reference
     CoordinateReferenceSystem crs = CRS.forCode("Proj4::+init=epsg:4326");
 
 Everything after `"PROJ4::"` is forwarded as-is to the Proj.4 library.
-Note that despite the `"epsg"` part in above definition string, CRS created by above method
call is **not**
-conform to EPSG:4326 authoritative definition. It should rather be understood as a Proj.4-specific
code.
+Note that despite the `"epsg"` part in above definition string, the CRS created by above
method call is **not**
+conform to EPSG:4326 authoritative definition. The string should rather be understood as
a Proj.4-specific code.
 Proj.4 definitions may differ from authoritative definitions in axis order, axis directions
or units of measurement.
 To get the authoritative definition, use `CRS.forCode("EPSG::4326")` instead.
 
@@ -62,6 +63,7 @@ For creating a coordinate operation back
 we can invoke the same method regardless if the CRS are backed by Proj.4 or Apache SIS.
 The following code will create a transform backed by Proj.4 if *both* `sourceCRS` and `targetCRS`
 were created with `CRS.forCode("Proj4::…")` calls.
+Note however that `CoordinateOperation` backed by Proj.4 does not provide metadata about
accuracy or domain of validity.
 
     :::java
     CoordinateOperation  op = CRS.findOperation(sourceCRS, targetCRS, null);

Modified: sis/site/trunk/content/index.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/index.mdtext?rev=1816195&r1=1816194&r2=1816195&view=diff
==============================================================================
--- sis/site/trunk/content/index.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/index.mdtext [UTF-8] Thu Nov 23 23:15:55 2017
@@ -38,7 +38,7 @@ Some Apache SIS features are:
       See the list of [supported coordinate reference systems](tables/CoordinateReferenceSystems.html).
     * Mercator, Transverse Mercator, Lambert Conic Conformal, stereographic and more map
projections.
       See the list of [supported operation methods](tables/CoordinateOperationMethods.html).
-    * [Bridge to Proj.4](gdal.html) as a complement to Apache SIS own referencing engine.
+    * Optional [bridge to Proj.4](gdal.html) as a complement to Apache SIS own referencing
engine.
   * Referencing by identifiers (ISO 19112:2003)
     * Geohashes (a simple encoding of geographic coordinates into short strings of letters
and digits).
     * Military Grid Reference System (MGRS), also used for some civilian uses.



Mime
View raw message