| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| |
| |
| <title>Apache SIS - Apache SIS downloads</title> |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
| <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/css/bootstrap.min.css" |
| rel="stylesheet" integrity="sha384-F3w7mX95PdgyTmZZMECAngseQB83DfGTowi0iMjiWaeVhAn4FJkqJByhZMI3AhiU" crossorigin="anonymous"> |
| <link rel="stylesheet" type="text/css" media="screen" href="./syntax.css"> |
| <link rel="stylesheet" type="text/css" media="screen" href="./sis.css"> |
| </head> |
| |
| <body> |
| |
| <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark"> |
| <div class="container-fluid"> |
| <a class="navbar-brand" href="./index.html"> Apache SIS™</a> |
| <ul class="navbar-nav me-auto mb-2 mb-md-0"> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" id="menuAbout" data-bs-toggle="dropdown" aria-expanded="false">About</a> |
| <ul class="dropdown-menu" aria-labelledby="menuAbout"> |
| <li><a class="dropdown-item" href="http://www.apache.org/licenses/">License</a></li> |
| <li><a class="dropdown-item" href="./mail-lists.html">Mailing Lists</a></li> |
| <li><a class="dropdown-item" href="./team-list.html">Project Team</a></li> |
| <li><a class="dropdown-item" href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy policy</a></li> |
| </ul> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" id="menuDownload" data-bs-toggle="dropdown" aria-expanded="false">Download</a> |
| <ul class="dropdown-menu" aria-labelledby="menuDownload"> |
| <li><a class="dropdown-item" href="./downloads.html">Downloads</a></li> |
| <li><a class="dropdown-item" href="./source.html">Checkout Sources</a></li> |
| <li><a class="dropdown-item" href="./epsg.html">EPSG Database</a></li> |
| </ul> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" id="menuDocumentation" data-bs-toggle="dropdown" aria-expanded="false">Documentation</a> |
| <ul class="dropdown-menu" aria-labelledby="menuDocumentation"> |
| <li><a class="dropdown-item" href="./apidocs/index.html">Online Javadoc</a></li> |
| <li><a class="dropdown-item" href="./book/en/developer-guide.html">Developer Guide</a></li> |
| <li><a class="dropdown-item" href="./howto.html">How to…</a></li> |
| <li><a class="dropdown-item" href="./formats.html">Supported formats</a></li> |
| <li><a class="dropdown-item" href="./tables/CoordinateReferenceSystems.html">Supported CRS</a></li> |
| <li><a class="dropdown-item" href="./tables/CoordinateOperationMethods.html">Map Projections</a></li> |
| <li><a class="dropdown-item" href="./code-patterns.html">Code Patterns</a></li> |
| <li><a class="dropdown-item" href="./faq.html">FAQ</a></li> |
| </ul> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" id="menuContribute" data-bs-toggle="dropdown" aria-expanded="false">Contribute</a> |
| <ul class="dropdown-menu" aria-labelledby="menuContribute"> |
| <li><a class="dropdown-item" href="./contributor.html">New Contributor</a></li> |
| <li><a class="dropdown-item" href="./coding-conventions.html">Coding Conventions</a></li> |
| <li><a class="dropdown-item" href="./mail-lists.html">Mailing Lists</a></li> |
| <li><a class="dropdown-item" href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li> |
| <li><a class="dropdown-item" href="https://github.com/apache/sis">GitHub mirror</a></li> |
| <li><a class="dropdown-item" href="https://cwiki.apache.org/confluence/display/SIS">Wiki</a></li> |
| <li><hr class="dropdown-divider"></li> |
| <li><a class="dropdown-item" href="./release-management.html">Release management</a></li> |
| </ul> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" id="menuASF" data-bs-toggle="dropdown" aria-expanded="false">The Foundation</a> |
| <ul class="dropdown-menu" aria-labelledby="menuASF"> |
| <li><a class="dropdown-item" href="http://www.apache.org">The Foundation</a></li> |
| <li><a class="dropdown-item" href="http://www.apache.org/foundation/sponsorship.html">Donate</a></li> |
| <li><a class="dropdown-item" href="http://www.apache.org/foundation/thanks.html">Thanks</a></li> |
| <li><a class="dropdown-item" href="http://www.apache.org/security/">Security</a></li> |
| </ul> |
| </li> |
| </ul> |
| <ul class="navbar-nav ml-auto mb-2 mb-md-0"> |
| <li class="nav-item"> |
| <a href="https://www.apache.org/events/current-event.html"> |
| <img class="apache-con" src="https://www.apache.org/events/current-event-234x60.png" alt="ApacheCon"/> |
| </a> |
| </li> |
| </ul> |
| </div> |
| </nav> |
| |
| |
| <div class="row flex-nowrap"> |
| <div class="d-flex flex-column flex-shrink-0 p-3 text-white bg-dark" style="width:13rem; min-height:40rem"> |
| <ul class="nav nav-pills flex-column mb-auto position-fixed"> |
| <li><a class="nav-link text-white " href="./index.html">Home</a></li> |
| <li><a class="nav-link text-white" href="http://www.apache.org/licenses/">License</a></li> |
| <li><a class="nav-link active " href="./downloads.html">Downloads</a></li> |
| <li><a class="nav-link text-white " href="./howto.html">How to…</a></li> |
| <li><a class="nav-link text-white " href="./standards.html">Standards</a></li> |
| <li><a class="nav-link text-white " href="./formats.html">Data formats</a></li> |
| <li><a class="nav-link text-white " href="./epsg.html">EPSG Database</a></li> |
| <li><a class="nav-link text-white " href="./javafx.html">Application (demo)</a></li> |
| <li><a class="nav-link text-white" href="./apidocs/index.html">Online Javadoc</a></li> |
| <li><a class="nav-link text-white" href="./book/en/developer-guide.html">Developer Guide</a></li> |
| <li><a class="nav-link text-white " href="./code-patterns.html">Code patterns</a></li> |
| <li><a class="nav-link text-white " href="./faq.html">FAQ</a></li> |
| </ul> |
| </div> |
| <div class="col"> |
| <main class="container"> |
| <article> |
| <img src="./images/logo.png" class="sis-logo" align="left"/> |
| <p class="page-title">Apache SIS downloads</p> |
| |
| <p>Apache <abbr title="Spatial Information System">SIS</abbr> 1.4 is now available. |
| See the <a href="release-notes/1.4.html">release notes</a> for a list of changes since the previous version.</p> |
| <p>Apache <abbr title="Spatial Information System">SIS</abbr> releases are available under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>. |
| See the <code>NOTICE</code> file contained in each release artifact for applicable copyright attribution notices.</p> |
| <nav id="TableOfContents"> |
| <ul> |
| <li><a href="#bundles">Download ZIP files </a> |
| <ul> |
| <li><a href="#release-gpg">Verify signatures </a></li> |
| <li><a href="#build">Build from the sources </a></li> |
| <li><a href="#module-path">Setting the module-path </a></li> |
| </ul> |
| </li> |
| <li><a href="#maven">Download as Maven dependencies </a> |
| <ul> |
| <li><a href="#non-free">Include non-free resources </a></li> |
| </ul> |
| </li> |
| </ul> |
| </nav> |
| <h1 id="bundles">Download ZIP files </h1> |
| <p>Apache <abbr title="Spatial Information System">SIS</abbr> is distributed in the form of Java source code in a multi-modules Apache Maven project. |
| For convenience, Javadoc and pre-compiled JAR files are available as separated downloads. |
| The precompiled JAR files contain most modules and mandatory dependencies. |
| Optional dependencies (JAXB implementation, UCAR netCDF library, Amazon SDK) are not included.</p> |
| <ul> |
| <li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.4/apache-sis-1.4-bin.zip">Apache SIS 1.4 binary</a> [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-bin.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-bin.zip.sha512">SHA 512</a>]</li> |
| <li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.4/apache-sis-1.4-doc.zip">Apache SIS 1.4 javadoc</a> [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-doc.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-doc.zip.sha512">SHA 512</a>]</li> |
| <li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.4/apache-sis-1.4-src.zip">Apache SIS 1.4 sources</a> [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-src.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.4/apache-sis-1.4-src.zip.sha512">SHA 512</a>]</li> |
| </ul> |
| <h2 id="release-gpg">Verify signatures </h2> |
| <p>All downloads can be verified using the Apache <abbr title="Spatial Information System">SIS</abbr> code signing <a href="https://www.apache.org/dist/sis/KEYS">KEYS</a>. |
| The PGP (<em>Pretty Good Privacy</em>) signatures can be verified using any OpenPGP implementation, for example GPG (<em>GNU Privacy Guard</em>). |
| First download the <a href="https://www.apache.org/dist/sis/KEYS">KEYS</a> file and the <code>.asc</code> signature files for the relevant release packages. |
| Make sure you get these files from the main distribution directory, rather than from a mirror. |
| Then verify the signatures using the following (replace <code>src</code> by <code>bin</code> or <code>doc</code> if needed):</p> |
| <p>Using GNU Privacy Guard:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">gpg --import KEYS |
| </span></span><span class="line"><span class="cl">gpg --verify apache-sis-1.4-src.zip.asc</span></span></code></pre></div> |
| <p>Using PGP version 6:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pgp -ka KEYS |
| </span></span><span class="line"><span class="cl">pgp apache-sis-1.4-src.zip.asc</span></span></code></pre></div> |
| <p>Using PGP version 5:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pgpk -a KEYS |
| </span></span><span class="line"><span class="cl">pgpv apache-sis-1.4-src.zip.asc</span></span></code></pre></div> |
| <h2 id="build">Build from the sources </h2> |
| <p>If the source files were donwloaded instead of the binaries, the sources will need to be built by Gradle. |
| It requires Java 18 or higher for building, but the compilation result can be executed on Java 11 or higher. |
| For installing the JAR files in the local Maven repository, execute the following command |
| from the SIS project root:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> apache-sis-1.4 |
| </span></span><span class="line"><span class="cl">gradle assemble |
| </span></span><span class="line"><span class="cl">gradle publishToMavenLocal <span class="c1"># If use with Maven projects is desired.</span></span></span></code></pre></div> |
| <p>JAR files will be in the <code>endorsed/build/libs/</code> sub-directory. |
| An Open/LibreOffice add-in will be in <code>endorsed/build/bundle/</code>.</p> |
| <p>The JavaFX application is excluded by default because it depends on |
| the <a href="https://openjfx.io/">JavaFX platform</a> which is distributed under GPL license |
| (note that the SIS module stay under Apache 2 licence). |
| Likewise the <a href="epsg.html">EPSG geodetic dataset</a> is excluded by default for licensing reasons. |
| For including the JavaFX module in the build, define the <code>PATH_TO_FX</code> environment variable |
| with the path to the directory containing all JavaFX JAR files. |
| Example on a Linux system (the path may vary):</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">PATH_TO_FX</span><span class="o">=</span>/usr/lib/jvm/openjfx</span></span></code></pre></div> |
| <p>The application will bundled in a ZIP file in the <code>optional/build/bundle</code> directory. |
| To test, uncompress in any directory and execute <code>apache-sis-1.4/bin/sisfx</code>.</p> |
| <h2 id="module-path">Setting the module-path </h2> |
| <p>Apache SIS 1.4 and later use the Java Platform Module System (JPMS). |
| Consequently applications should declare SIS JAR files on their module-path rather than their class-path. |
| The easiest way is to declare the whole directory like below:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">java --module-path apache-sis-1.4/lib</span></span></code></pre></div> |
| <p>If the application using Apache SIS is not itself modularized, |
| it may be necessary to add the <code>--add-modules ALL-MODULE-PATH</code> option. |
| If it is not possible to declare SIS JAR files on the module-path, |
| a compatibility mechanism makes possible to nevertheless use SIS 1.4 on the class-path. |
| Note however that declaring SIS JAR files on the class-path may be no longer supported in a future version |
| (it does <strong>not</strong> mean that applications using SIS must put themselves on the module-path).</p> |
| <h1 id="maven">Download as Maven dependencies </h1> |
| <p>An easy approach to integrate Apache <abbr title="Spatial Information System">SIS</abbr> into a Java project uses the <a href="http://maven.apache.org/">Apache Maven</a> |
| dependency management tool to automatically obtain the required Java Archives (JAR) files from the network. |
| Below are examples of declarations in a <code>pom.xml</code> file for building a project with a SIS core module.</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-xml" data-lang="xml"><span class="line"><span class="cl"><span class="nt"><properties></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><sis.version></span>1.4<span class="nt"></sis.version></span> |
| </span></span><span class="line"><span class="cl"><span class="nt"></properties></span> |
| </span></span><span class="line"><span class="cl"> |
| </span></span><span class="line"><span class="cl"><span class="nt"><dependencies></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><dependency></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><groupId></span>org.apache.sis.core<span class="nt"></groupId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><artifactId></span>sis-referencing<span class="nt"></artifactId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><version></span>${sis.version}<span class="nt"></version></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"></dependency></span> |
| </span></span><span class="line"><span class="cl"> |
| </span></span><span class="line"><span class="cl"> <span class="c"><!-- The following dependency can be omitted if XML support is not desired. --></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><dependency></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><groupId></span>org.glassfish.jaxb<span class="nt"></groupId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><artifactId></span>jaxb-runtime<span class="nt"></artifactId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><version></span>4.0.4<span class="nt"></version></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><scope></span>runtime<span class="nt"></scope></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"></dependency></span> |
| </span></span><span class="line"><span class="cl"><span class="nt"></dependencies></span></span></span></code></pre></div> |
| <p>The <code>sis-referencing</code> module in above example can be replaced by one or many of the following modules:</p> |
| <table> |
| <tr><th>Service</th> <th>Java module name</th> <th>Maven group</th> <th>Maven artifact</th></tr> |
| <tr><td>ISO 19115 metadata</td> <td><code>org.apache.sis.metadata</code></td> <td><code>org.apache.sis.core</code></td> <td><code>sis-metadata</code></td></tr> |
| <tr><td>Referencing by coordinates</td> <td><code>org.apache.sis.referencing</code></td> <td><code>org.apache.sis.core</code></td> <td><code>sis-referencing</code></td></tr> |
| <tr><td>Referencing by identifiers</td> <td><code>org.apache.sis.referencing.gazetteer</code></td> <td><code>org.apache.sis.core</code></td> <td><code>sis-referencing-by-identifiers</code></td></tr> |
| <tr><td>Features and coverages</td> <td><code>org.apache.sis.feature</code></td> <td><code>org.apache.sis.core</code></td> <td><code>sis-feature</code></td></tr> |
| <tr><td>Feature data from SQL database</td> <td><code>org.apache.sis.storage.sql</code></td> <td><code>org.apache.sis.storage</code></td> <td><code>sis-sqlstore</code></td></tr> |
| <tr><td>Feature data from GPX files</td> <td><code>org.apache.sis.storage.xml</code></td> <td><code>org.apache.sis.storage</code></td> <td><code>sis-xmlstore</code></td></tr> |
| <tr><td>Features and rasters from NetCDF</td> <td><code>org.apache.sis.storage.netcdf</code></td> <td><code>org.apache.sis.storage</code></td> <td><code>sis-netcdf</code></td></tr> |
| <tr><td>Raster data from GeoTIFF</td> <td><code>org.apache.sis.storage.geotiff</code></td> <td><code>org.apache.sis.storage</code></td> <td><code>sis-geotiff</code></td></tr> |
| <tr><td>Raster data from Landsat</td> <td><code>org.apache.sis.storage.earthobservation</code></td> <td><code>org.apache.sis.storage</code></td> <td><code>sis-earth-observation</code></td></tr> |
| <tr><td>Raster data from GCOM (JAXA)</td> <td><code>org.apache.sis.profile.japan</code></td> <td><code>org.apache.sis.profile</code></td> <td><code>sis-japan-profile</code></td></tr> |
| <tr><td>Connection to storages on cloud</td> <td><code>org.apache.sis.cloud.aws</code></td> <td><code>org.apache.sis.cloud</code></td> <td><code>sis-cloud-aws</code></td></tr> |
| <tr><td>Console application</td> <td><code>org.apache.sis.console</code></td> <td><code>org.apache.sis.application</code></td> <td><code>sis-console</code></td></tr> |
| <tr><td>Graphical application</td> <td><code>org.apache.sis.gui</code></td> <td><code>org.apache.sis.application</code></td> <td><code>sis-javafx</code></td></tr> |
| </table> |
| <h2 id="non-free">Include non-free resources </h2> |
| <p>The <a href="https://epsg.org/">EPSG geodetic dataset</a> is optional but strongly recommended. |
| The EPSG dataset is a de-facto standard providing |
| <a href="tables/CoordinateReferenceSystems.html">thousands of Coordinate Reference System (CRS) definitions</a> |
| together with information about how to perform coordinate operations, their accuracies and their domains of validity. |
| However usage of EPSG dataset requires acceptation of <a href="https://epsg.org/terms-of-use.html">EPSG terms of use</a>. |
| If you accept those terms of use, then the following dependency can be added:</p> |
| <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-xml" data-lang="xml"><span class="line"><span class="cl"><span class="nt"><dependencies></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><dependency></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><groupId></span>org.apache.sis.non-free<span class="nt"></groupId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><artifactId></span>sis-embedded-data<span class="nt"></artifactId></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><version></span>${sis.version}<span class="nt"></version></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"><scope></span>runtime<span class="nt"></scope></span> |
| </span></span><span class="line"><span class="cl"> <span class="nt"></dependency></span> |
| </span></span><span class="line"><span class="cl"><span class="nt"></dependencies></span></span></span></code></pre></div> |
| <p>Above dependency uses a read-only embedded Derby database. |
| Note that the need to uncompress the <code>sis-embedded-data.jar</code> file |
| slows down <code>CRS.forCode(…)</code> and <code>CRS.findCoordinateOperation(…)</code> 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 <a href="epsg.html">How to use EPSG geodetic dataset</a> page for more information.</p> |
| |
| |
| </article> |
| </main> |
| <footer class="footer"> |
| <div class="container"> |
| <p> |
| Copyright © 2013-2023 The Apache Software Foundation, Licensed under the |
| <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/> |
| Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software Foundation. |
| </p> |
| </div> |
| </footer> |
| </div> |
| </div> |
| |
| <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.1.1/dist/js/bootstrap.bundle.min.js" |
| integrity="sha384-/bQdsTh/da6pkI1MST/rWKFNjaCP5gBSY4sEBT38Q/9RBh9AH40zEOg7Hlq2THRZ" crossorigin="anonymous"></script> |
| |
| </body> |
| </html> |