sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1839654 - in /sis/site/trunk/content: downloads.mdtext epsg.mdtext index.mdtext
Date Thu, 30 Aug 2018 09:34:42 GMT
Author: desruisseaux
Date: Thu Aug 30 09:34:42 2018
New Revision: 1839654

URL: http://svn.apache.org/viewvc?rev=1839654&view=rev
Log:
Add a note about the performance impact of using a compressed sis-embedded-data.jar file.

Modified:
    sis/site/trunk/content/downloads.mdtext
    sis/site/trunk/content/epsg.mdtext
    sis/site/trunk/content/index.mdtext

Modified: sis/site/trunk/content/downloads.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/downloads.mdtext?rev=1839654&r1=1839653&r2=1839654&view=diff
==============================================================================
--- sis/site/trunk/content/downloads.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/downloads.mdtext [UTF-8] Thu Aug 30 09:34:42 2018
@@ -114,8 +114,10 @@ If you accept those terms of use, then t
     </dependencies>
 
 Above dependency uses a read-only embedded Derby database.
-But it is also possible to use an EPSG database on HSQL or PostgreSQL,
-or a database allowing additions of user definitions.
+Note that the requirement to uncompress the `sis-embedded-data.jar` file
+slows down `CRS.forCode(…)` and `CRS.findCoordinateOperation(…)` method executions.
+For better flexibility and performance, it is also possible to use an uncompressed
+and writable Derby database, or to install the EPSG dataset on HSQL or PostgreSQL.
 See [How to use EPSG geodetic dataset](epsg.html) page for more information.
 
 

Modified: sis/site/trunk/content/epsg.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/epsg.mdtext?rev=1839654&r1=1839653&r2=1839654&view=diff
==============================================================================
--- sis/site/trunk/content/epsg.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/epsg.mdtext [UTF-8] Thu Aug 30 09:34:42 2018
@@ -65,6 +65,10 @@ try adding a `derby-<version>.jar` file
 This is normally not needed with Oracle JDK6, JDK7 or JDK8 because Apache SIS tries to use
the JavaDB embedded
 in those distributions, but may be necessary with other distributions or in security-constrained
environments.
 
+
+Use the local copy in other applications    {#use-local}
+--------------------------------------------------------
+
 For using the installed EPSG geodetic dataset in your own application, apply *one* of the
following choices:
 
   * Set the `SIS_DATA` environment variable to the path of `apache-sis-0.8/data` directory
_(preferred choice)_.
@@ -125,7 +129,7 @@ if that database is specified by JNDI):
       <dependency>
         <groupId>org.apache.derby</groupId>
         <artifactId>derby</artifactId>
-        <version>10.13.1.1</version>
+        <version>10.14.2.0</version>
         <scope>runtime</scope>
       </dependency>
     </dependencies>
@@ -138,11 +142,17 @@ As embedded database     {#maven-embedde
 ------------------------------------------
 
 With `sis-embedded-data` artifact on the classpath, there is no need to setup environment
variable, Java property or JNDI.
-However this simplicity come with the following inconvenient: a larger download, no option
for choosing which data to use
-(and consequently which license to accept), no possibility to choose the database engine
(i.e. the database software is
-fixed to Derby), and no possibility to add user data (i.e. the database is read-only).
+However this simplicity come with the following inconvenient:
+
+  * a larger download,
+  * no option for choosing which data to use (and consequently which license to accept),
+  * no possibility to choose the database engine (i.e. the database software is fixed to
Derby),
+  * no possibility to add user data (i.e. the database is read-only),
+  * slower execution of `CRS.forCode(…)` and `CRS.findCoordinateOperation(…)`, unless
the JAR file is uncompressed.
+
 This dependency can be declared as below
-(note that `sis-epsg` and `sis-embedded-data` should not be specified in the same project;
only one is needed):
+(see the [download](downloads.html#epsg) page for more information about Maven dependency
declaration).
+Note that `sis-epsg` and `sis-embedded-data` should not be specified in the same project;
only one is needed:
 
     :::xml
     <dependencies>
@@ -154,7 +164,13 @@ This dependency can be declared as below
       </dependency>
     </dependencies>
 
-See the [download](downloads.html#epsg) page for more information about Maven dependency
declaration.
+The performance issue can be avoided if the JAR file is uncompressed.
+But uncompressed `sis-embedded-data.jar` file is more than 5 times larger than the compressed
file.
+Given that `CRS.forCode(…)` and `CRS.findCoordinateOperation(…)` should not be invoked
too often,
+and that performance degradation does not apply to the `CoordinateOperation` instances created
by those method calls,
+the JAR file is distributed on the Maven repository in its compressed form.
+If desired, better performance can be achieved by using one of the other configurations described
in this page,
+or by uncompressing `sis-embedded-data.jar` locally.
 
 
 

Modified: sis/site/trunk/content/index.mdtext
URL: http://svn.apache.org/viewvc/sis/site/trunk/content/index.mdtext?rev=1839654&r1=1839653&r2=1839654&view=diff
==============================================================================
--- sis/site/trunk/content/index.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/index.mdtext [UTF-8] Thu Aug 30 09:34:42 2018
@@ -73,7 +73,7 @@ Following links are for those who wish t
 
   * [New contributor](contributor.html): background knowledge.
   * [Source code](source.html): fetching the code, choosing a branch, opening in an IDE,
formatting.
-  * [Build](build.html): build from the source, create the PACK200 file.
+  * [Build](build.html): build from the source, create the distribution file.
   * [Issue tracking][JIRA]: JIRA.
   * [Release management](release-management.html) (for release managers)
   * [Web site management](site-management.html) (for release managers and site maintainers)



Mime
View raw message