This is an automated email from the ASF dual-hosted git repository. desruisseaux pushed a commit to branch asf-staging in repository https://gitbox.apache.org/repos/asf/sis-site.git
The following commit(s) were added to refs/heads/asf-staging by this push: new 5c2ec2fd Regenerate the static pages after typo fixes (publication date, etc). 5c2ec2fd is described below commit 5c2ec2fd2fd8a49ff2ce8c34a54f9b2635ed356b Author: Martin Desruisseaux <martin.desruisse...@geomatys.com> AuthorDate: Thu Jun 8 16:10:54 2023 +0200 Regenerate the static pages after typo fixes (publication date, etc). --- build.html | 6 +- downloads.html | 6 +- howto.html | 8 +-- howto/crs_equality.html | 4 +- howto/datalake_to_datacube.html | 4 +- howto/envelopes_in_different_crs.html | 4 +- howto/export_metadata_to_xml.html | 4 +- howto/geodetic_paths.html | 4 +- howto/geographic_bounding_box.html | 4 +- howto/index.xml | 76 +++++++++++----------- howto/instantiate_utm_projection.html | 4 +- howto/lookup_crs_urn.html | 4 +- howto/parallel_computation.html | 4 +- howto/parse_and_format_mgrs_codes.html | 4 +- howto/raster_values_at_geographic_coordinates.html | 4 +- howto/raster_values_at_pixel_coordinates.html | 4 +- howto/rasters_bigger_than_memory.html | 4 +- howto/read_geotiff.html | 4 +- howto/read_netcdf.html | 4 +- howto/resample_raster.html | 4 +- howto/transform_coordinates.html | 4 +- howto/transform_envelopes.html | 4 +- howto/write_raster.html | 4 +- index.html | 2 +- source.html | 18 ----- standards.html | 4 +- 26 files changed, 89 insertions(+), 107 deletions(-) diff --git a/build.html b/build.html index 2477946d..26e1c8a2 100644 --- a/build.html +++ b/build.html @@ -109,18 +109,18 @@ It requires Java 17 or higher for building, but the compilation result can be executed on Java 8 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">mvn install</span></span></code></pre></div> +<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mvn install --define skipTests</span></span></code></pre></div> <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 and the use of EPSG dataset in the build:</p> -<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mvn install --activate-profiles javafx,non-free</span></span></code></pre></div> +<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mvn install --define skipTests --activate-profiles javafx,non-free</span></span></code></pre></div> <p>For signing the artifacts and producing distribution files (<code>apache-sis-bin.zip</code> and <code>apache-sis.oxt</code>), execute the following command. Note that it requires an OpenPGP (<em>Open Pretty Good Privacy</em>) software for cryptography signatures (more information on the <a href="release-management-setup.html#generate-key">release management setup</a> page):</p> -<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mvn install --activate-profiles apache-release</span></span></code></pre></div> +<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mvn install --define skipTests --activate-profiles apache-release</span></span></code></pre></div> <p>The remaining of this page provides more advanced tips for SIS developers.</p> <nav id="TableOfContents"> <ul> diff --git a/downloads.html b/downloads.html index e9c82397..b31e5521 100644 --- a/downloads.html +++ b/downloads.html @@ -126,13 +126,13 @@ See the <code>NOTICE</code> file contained in each release artifact for applicab </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, an aggregated Javadoc and pre-compiled JAR files are available as separated downloads. +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.3/apache-sis-1.3-src.zip">Apache SIS 1.3 sources</a> [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-src.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-src.zip.sha512">SHA 512</a>] (<a href="build.html">build from source</a>)</li> -<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.3/apache-sis-1.3-doc.zip">Apache SIS 1.3 javadoc</a> [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-doc.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-doc.zip.sha512">SHA 512</a>]</li> <li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.3/apache-sis-1.3-bin.zip">Apache SIS 1.3 binary</a> [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-bin.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-bin.zip.sha512">SHA 512</a>]</li> +<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.3/apache-sis-1.3-doc.zip">Apache SIS 1.3 javadoc</a> [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-doc.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-doc.zip.sha512">SHA 512</a>]</li> +<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.3/apache-sis-1.3-src.zip">Apache SIS 1.3 sources</a> [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-src.zip.asc">PGP</a>] [<a href="https://www.apache.org/dist/sis/1.3/apache-sis-1.3-src.zip.sha512">SHA 512</a>] (<a href="build.html">build instruction</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>. diff --git a/howto.html b/howto.html index 19d3cd7e..064314ed 100644 --- a/howto.html +++ b/howto.html @@ -1,9 +1,9 @@ <!DOCTYPE html> <html lang="en"> <head> - - <title>Apache SIS - How to</title> + + <title>Apache SIS - How to…</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" @@ -103,8 +103,8 @@ <main class="container"> <article> <img src="./images/logo.png" class="sis-logo" align="left"/> - <p class="page-title">How to</p> - + <p class="page-title">How to…</p> + <p>Java code examples for performing some tasks with Apache <abbr title="Spatial Information System">SIS</abbr>. The examples are grouped in the following sections:</p> <nav id="TableOfContents"> diff --git a/howto/crs_equality.html b/howto/crs_equality.html index a1c37686..917f2b81 100644 --- a/howto/crs_equality.html +++ b/howto/crs_equality.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Determine if two CRS are functionally equal</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Determine if two CRS are functionally equal</p> - + <p>Two Coordinate Reference Systems may not be considered equal if they are associated to different metadata (name, identifiers, scope, domain of validity, remarks), even though they represent the same logical <abbr title="Coordinate Reference System">CRS</abbr>. In order to test if two <abbr title="Coordinate Reference System">CRS</abbr> are functionally equivalent, diff --git a/howto/datalake_to_datacube.html b/howto/datalake_to_datacube.html index 7007e0a9..9fe76616 100644 --- a/howto/datalake_to_datacube.html +++ b/howto/datalake_to_datacube.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - From data lake to data cube</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">From data lake to data cube</p> - + <p>This example opens a few files where each file represent a slice in a data cube. Then the slices are aggregated together in a single multi-dimensional data cube. For example each file may be a raster representing Sea Surface Temperature (SST) at a specific day, diff --git a/howto/envelopes_in_different_crs.html b/howto/envelopes_in_different_crs.html index c1f5cd91..89e78020 100644 --- a/howto/envelopes_in_different_crs.html +++ b/howto/envelopes_in_different_crs.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Union or intersection of envelopes in different CRS</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Union or intersection of envelopes in different CRS</p> - + <p>Before to compute the union or intersection of two or more envelopes (bounding boxes), all envelopes must be <a href="transform_envelopes.html">transformed</a> to the same Coordinate Reference System (CRS). But the choice of a common <abbr title="Coordinate Reference System">CRS</abbr> is not easy. diff --git a/howto/export_metadata_to_xml.html b/howto/export_metadata_to_xml.html index 591b39c5..8fa2b717 100644 --- a/howto/export_metadata_to_xml.html +++ b/howto/export_metadata_to_xml.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Geographic bounding box of a data file</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Geographic bounding box of a data file</p> - + <p>This example prints the metadata of a netCDF file in the XML format defined by the ISO 19115-3 international standard. The coverage values are not read, only the netCDF file header is read.</p> diff --git a/howto/geodetic_paths.html b/howto/geodetic_paths.html index ead96bfb..365ba692 100644 --- a/howto/geodetic_paths.html +++ b/howto/geodetic_paths.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Compute geodetic distances and paths</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Compute geodetic distances and paths</p> - + <p>The following example computes the geodetic distance between given positions. The geodetic distance is the shortest distance on Earth ellipsoid. Apache SIS can also compute the path as a Béziers curve, diff --git a/howto/geographic_bounding_box.html b/howto/geographic_bounding_box.html index b9f4ac4b..278b84bd 100644 --- a/howto/geographic_bounding_box.html +++ b/howto/geographic_bounding_box.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Geographic bounding box of a data file</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Geographic bounding box of a data file</p> - + <p>This example prints the bounding box of a GeoTIFF image. The pixel values are not read, only the GeoTIFF file header is read. If the file contains many images, the bounding box of each image is printed.</p> diff --git a/howto/index.xml b/howto/index.xml index f15c8c36..f1f7f957 100644 --- a/howto/index.xml +++ b/howto/index.xml @@ -10,187 +10,187 @@ <title>Compute geodetic distances and paths</title> <link>https://sis.apache.org/howto/geodetic_paths.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/geodetic_paths.html</guid> <description>The following example computes the geodetic distance between given positions. The geodetic distance is the shortest distance on Earth ellipsoid. Apache SIS can also compute the path as a Béziers curve, with the property that the azimuths at the two curve extremities are preserved. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.storage:sis-referencing org.apache.sis.referencing Code example Note that all geographic coordinates below express latitude before longitude.</description> </item> - + <item> <title>Determine if two CRS are functionally equal</title> <link>https://sis.apache.org/howto/crs_equality.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/crs_equality.html</guid> <description>Two Coordinate Reference Systems may not be considered equal if they are associated to different metadata (name, identifiers, scope, domain of validity, remarks), even though they represent the same logical CRS. In order to test if two CRS are functionally equivalent, Utilities.equalsIgnoreMetadata(myFirstCRS, mySecondCRS) can be used. In some cases, equalsIgnoreMetadata(…) may fail to see that two reference systems are equal. It may happen for example when two map projections are defined with different parameters, but are mathematically equivalent.</description> </item> - + <item> <title>From data lake to data cube</title> <link>https://sis.apache.org/howto/datalake_to_datacube.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/datalake_to_datacube.html</guid> <description>This example opens a few files where each file represent a slice in a data cube. Then the slices are aggregated together in a single multi-dimensional data cube. For example each file may be a raster representing Sea Surface Temperature (SST) at a specific day, and those files can be a aggregated in a single three-dimensional raster with a temporal dimension. A current limitation is that each slice must have the same number of dimensions than the data cube.</description> </item> - + <item> <title>Geographic bounding box of a data file</title> <link>https://sis.apache.org/howto/export_metadata_to_xml.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/export_metadata_to_xml.html</guid> <description>This example prints the metadata of a netCDF file in the XML format defined by the ISO 19115-3 international standard. The coverage values are not read, only the netCDF file header is read. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.storage:sis-netcdf org.apache.sis.storage.netcdf edu.ucar:cdm-core For netCDF-4 or HDF5 The cdm-core dependency can be omitted for netCDF-3 (a.k.a. &ldquo;classic&rdquo;), GeoTIFF or any other formats supported by Apache SIS.</description> </item> - + <item> <title>Geographic bounding box of a data file</title> <link>https://sis.apache.org/howto/geographic_bounding_box.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/geographic_bounding_box.html</guid> <description>This example prints the bounding box of a GeoTIFF image. The pixel values are not read, only the GeoTIFF file header is read. If the file contains many images, the bounding box of each image is printed. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.storage:sis-geotiff org.apache.sis.storage.geotiff org.apache.sis.non-free:sis-embedded-data org.apache.sis.referencing.database Optional. Non-Apache license. The EPSG dependency may or may not be needed, depending how the Coordinate Reference System (CRS) is encoded in the GeoTIFF file.</description> </item> - + <item> <title>Get raster values at geographic coordinates</title> <link>https://sis.apache.org/howto/raster_values_at_geographic_coordinates.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/raster_values_at_geographic_coordinates.html</guid> <description>This example fetches values at given geospatial coordinates in a raster. The coordinates can be expressed in different Coordinate Reference System (CRS). Conversions from geographic or projected coordinates to pixel coordinates, optionally followed by conversions from raster data to units of measurement, are done automatically. Raster data and spatiotemporal coordinates can have more than two dimensions. This example assumes a preloaded three-dimensional raster. For the loading part, see read from a netCDF file or read from a GeoTIFF file code examples.</description> </item> - + <item> <title>Get raster values at pixel coordinates</title> <link>https://sis.apache.org/howto/raster_values_at_pixel_coordinates.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/raster_values_at_pixel_coordinates.html</guid> <description>This example fetches values at given pixel coordinates in a raster. This example assumes a preloaded three-dimensional raster. For the loading part, see read from a netCDF file or read from a GeoTIFF file code examples. Some file formats store values as integers for compactness reasons, but provide a transfer function for converting those integers to &ldquo;real world&rdquo; values. Apache SIS can provide either the original integers or the converted values, at user&rsquo;s choice.</description> </item> - + <item> <title>Get the EPSG code or URN of an existing CRS</title> <link>https://sis.apache.org/howto/lookup_crs_urn.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/lookup_crs_urn.html</guid> <description>The identifier of a Coordinate Reference System (CRS) object can be obtained by the getIdentifiers() method, which usually return a collection of zero or one element. If the CRS has been created from a Well Known Text (WKT) parsing and the WKT ends with an AUTHORITY[&quot;EPSG&quot;, &quot;xxxx&quot;] (WKT version 1) or ID[&quot;EPSG&quot;, xxxx] (WKT version 2) element, then the identifier (an EPSG numerical code in this example) is the xxxx va [...] </item> - + <item> <title>Handle rasters bigger than memory</title> <link>https://sis.apache.org/howto/rasters_bigger_than_memory.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/rasters_bigger_than_memory.html</guid> <description>This example opens a big GeoTIFF file without reading the tiles immediately. Instead, tiles will be read only when requested by a call to the Java2D RenderedImage.getTile(int, int) method. Loaded tiles are cached by soft references, i.e. they may be discarted and reloaded when needed again. This approach allows processing of raster data larger than memory, provided that the application does not request all tiles at once. It integrates well with operations provided by A [...] </item> - + <item> <title>Instantiate a UTM projection</title> <link>https://sis.apache.org/howto/instantiate_utm_projection.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/instantiate_utm_projection.html</guid> <description>The Universal Transverse Mercator (UTM) projection divides the world in 60 zones. If the UTM zone is unknown, an easy way to instantiate the projection is to invoke the universal(…) method on one of the CommonCRS predefined constants. That method receives in argument a geographic coordinate in (latitude, longitude) order and computes the UTM zone from it. It takes in account the special cases of Norway and Svalbard. An alternative, more standard, way using geographic coordinates is to format an &ldquo;AUTO&rdquo; authority code.</description> </item> - + <item> <title>Parallel computation</title> <link>https://sis.apache.org/howto/parallel_computation.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/parallel_computation.html</guid> <description>Some grid coverages will read or compute chunks of data only when first requested. For example when a coverage is the result of a reprojection, or when a big coverage uses deferred tile reading. However if tiles are always requested in the same thread, it will result in a sequential, mono-threaded computation. Furthermore it may cause a lot of seek or &ldquo;HTTP range&rdquo; operations if tiles are read in random order.</description> </item> - + <item> <title>Parse and format MGRS codes</title> <link>https://sis.apache.org/howto/parse_and_format_mgrs_codes.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/parse_and_format_mgrs_codes.html</guid> <description>The following example converts geographic coordinates to Military Grid Reference System (MGRS) codes and conversely. MGRS codes can be seen as a kind of GeoHash but with better properties. Apache SIS supports also GeoHash if desired, in a way similar to this example. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.storage:sis-referencing org.apache.sis.referencing Code example Note that all geographic coordinates below express latitude before longitude.</description> </item> - + <item> <title>Read raster from a GeoTIFF file</title> <link>https://sis.apache.org/howto/read_geotiff.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/read_geotiff.html</guid> <description>This example reads data in GeoTIFF format. Contrarily to other formats such as PNG or JPEG, a GeoTIFF file can contain an arbitrary number of images. For this reason, GeoTiffStore does not implement directly GridCoverageResource. Instead, GeoTiffStore implements the Aggregate interface. This example assumes that the raster, optionally clipped to a subregion, can fit in memory. For potentially much bigger rasters, see rasters bigger than memory code example. Direct dependencies Maven coordinates Module info Remarks org.</description> </item> - + <item> <title>Read raster from a netCDF file</title> <link>https://sis.apache.org/howto/read_netcdf.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/read_netcdf.html</guid> <description>This example reads data in netCDF format. Contrarily to other formats such as PNG or JPEG, a netCDF file can contain an arbitrary number of variables with none of them identified as the main data. Furthermore those data are not necessarily rasters. For this reason, NetcdfStore does not implement directly GridCoverageResource. Instead, NetcdfStore implements the Aggregate interface and the desired variable must be specified. The variables may be instances of GridCoverag [...] </item> - + <item> <title>Resample a raster</title> <link>https://sis.apache.org/howto/resample_raster.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/resample_raster.html</guid> <description>This example reprojects a raster to a different Coordinate Reference System (CRS). This example assumes a preloaded two-dimensional raster. For the loading part, see read from a netCDF file or read from a GeoTIFF file code examples. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.code:sis-feature org.apache.sis.feature org.apache.sis.non-free:sis-embedded-data org.apache.sis.referencing.database Non-Apache license. The EPSG dependency is necessary for this example because a Coordinate Reference System (CRS) is instantiated from its EPSG code.</description> </item> - + <item> <title>Transform coordinates</title> <link>https://sis.apache.org/howto/transform_coordinates.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/transform_coordinates.html</guid> <description>The following Java code projects geographic coordinates from the World Geodetic System 1984 (WGS84) to WGS 84 / UTM zone 33N. In order to make the example a little bit simpler, this code uses predefined constants given by the CommonCRS convenience class. But more advanced applications may use EPSG codes or definitions in Well-Known Text (WKT) instead. Note: if the result of a coordinate transformation seems wrong, see the FAQ page.</description> </item> - + <item> <title>Transform envelopes (bounding boxes)</title> <link>https://sis.apache.org/howto/transform_envelopes.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/transform_envelopes.html</guid> <description>The transformation of envelopes (or bounding boxes) is a much more difficult task than transforming the four corners of a rectangle. The rectangle straight lines in source CRS may become curves in the target CRS with minimum and maximum values that are not located in any corner. The calculation is also more complicated if the envelope contains a pole or crosses the anti-meridian. Apache SIS handles those complexities in convenience static methods.</description> </item> - + <item> <title>Union or intersection of envelopes in different CRS</title> <link>https://sis.apache.org/howto/envelopes_in_different_crs.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/envelopes_in_different_crs.html</guid> <description>Before to compute the union or intersection of two or more envelopes (bounding boxes), all envelopes must be transformed to the same Coordinate Reference System (CRS). But the choice of a common CRS is not easy. We must verify that all envelopes are inside the domain of validity of the common CRS, which may require to choose a common CRS different than the CRS of all envelopes. Apache SIS can handle this task automatically.</description> </item> - + <item> <title>Write a raster to a file</title> <link>https://sis.apache.org/howto/write_raster.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - + <guid>https://sis.apache.org/howto/write_raster.html</guid> <description>This example saves a raster in PNG format. This example assumes a preloaded raster. For the loading part, see read from a netCDF file or read from a GeoTIFF file code examples. Note: this example is incomplete. A more complete example will be provided with next Apache SIS release. Direct dependencies Maven coordinates Module info Remarks org.apache.sis.storage:sis-storage org.apache.sis.storage Code example The file name in following code need to be updated for yours data.</description> </item> - + </channel> </rss> diff --git a/howto/instantiate_utm_projection.html b/howto/instantiate_utm_projection.html index 3eaa0c5b..3cf1e732 100644 --- a/howto/instantiate_utm_projection.html +++ b/howto/instantiate_utm_projection.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Instantiate a UTM projection</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Instantiate a UTM projection</p> - + <p>The Universal Transverse Mercator (UTM) projection divides the world in 60 zones. If the UTM zone is unknown, an easy way to instantiate the projection is to invoke the <code>universal(…)</code> method on one of the <code>CommonCRS</code> predefined constants. diff --git a/howto/lookup_crs_urn.html b/howto/lookup_crs_urn.html index 173d9e03..d9c51d56 100644 --- a/howto/lookup_crs_urn.html +++ b/howto/lookup_crs_urn.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Get the EPSG code or URN of an existing CRS</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Get the EPSG code or URN of an existing CRS</p> - + <p>The <em>identifier</em> of a Coordinate Reference System (CRS) object can be obtained by the <code>getIdentifiers()</code> method, which usually return a collection of zero or one element. If the <abbr title="Coordinate Reference System">CRS</abbr> has been created from a Well Known Text (WKT) parsing diff --git a/howto/parallel_computation.html b/howto/parallel_computation.html index a18aa5c5..83aa9345 100644 --- a/howto/parallel_computation.html +++ b/howto/parallel_computation.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Parallel computation</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Parallel computation</p> - + <p>Some grid coverages will read or compute chunks of data only when first requested. For example when a coverage is the <a href="resample_raster.html">result of a reprojection</a>, or when a big coverage <a href="rasters_bigger_than_memory.html">uses deferred tile reading</a>. diff --git a/howto/parse_and_format_mgrs_codes.html b/howto/parse_and_format_mgrs_codes.html index 18245077..cc147965 100644 --- a/howto/parse_and_format_mgrs_codes.html +++ b/howto/parse_and_format_mgrs_codes.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Parse and format MGRS codes</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Parse and format MGRS codes</p> - + <p>The following example converts geographic coordinates to Military Grid Reference System (MGRS) codes and conversely. MGRS codes can be seen as a kind of GeoHash but with better properties. diff --git a/howto/raster_values_at_geographic_coordinates.html b/howto/raster_values_at_geographic_coordinates.html index 4be22063..1d175b16 100644 --- a/howto/raster_values_at_geographic_coordinates.html +++ b/howto/raster_values_at_geographic_coordinates.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Get raster values at geographic coordinates</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Get raster values at geographic coordinates</p> - + <p>This example fetches values at given geospatial coordinates in a raster. The coordinates can be expressed in different Coordinate Reference System (CRS). Conversions from geographic or projected coordinates to pixel coordinates, diff --git a/howto/raster_values_at_pixel_coordinates.html b/howto/raster_values_at_pixel_coordinates.html index 9e775ace..90cc26be 100644 --- a/howto/raster_values_at_pixel_coordinates.html +++ b/howto/raster_values_at_pixel_coordinates.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Get raster values at pixel coordinates</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Get raster values at pixel coordinates</p> - + <p>This example fetches values at given pixel coordinates in a raster. This example assumes a preloaded three-dimensional raster. For the loading part, diff --git a/howto/rasters_bigger_than_memory.html b/howto/rasters_bigger_than_memory.html index fe52ab6f..1a25b003 100644 --- a/howto/rasters_bigger_than_memory.html +++ b/howto/rasters_bigger_than_memory.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Handle rasters bigger than memory</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Handle rasters bigger than memory</p> - + <p>This example opens a big GeoTIFF file without reading the tiles immediately. Instead, tiles will be read only when requested by a call to the Java2D <code>RenderedImage.getTile(int, int)</code> method. Loaded tiles are cached by soft references, i.e. they may be discarted and reloaded when needed again. diff --git a/howto/read_geotiff.html b/howto/read_geotiff.html index f1c013fe..4a4a10ac 100644 --- a/howto/read_geotiff.html +++ b/howto/read_geotiff.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Read raster from a GeoTIFF file</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Read raster from a GeoTIFF file</p> - + <p>This example reads data in GeoTIFF format. Contrarily to other formats such as PNG or JPEG, a GeoTIFF file can contain an arbitrary number of images. diff --git a/howto/read_netcdf.html b/howto/read_netcdf.html index baeeddcb..9dde9005 100644 --- a/howto/read_netcdf.html +++ b/howto/read_netcdf.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Read raster from a netCDF file</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Read raster from a netCDF file</p> - + <p>This example reads data in netCDF format. Contrarily to other formats such as PNG or JPEG, a netCDF file can contain an arbitrary number of variables diff --git a/howto/resample_raster.html b/howto/resample_raster.html index a0f043b4..fc976145 100644 --- a/howto/resample_raster.html +++ b/howto/resample_raster.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Resample a raster</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Resample a raster</p> - + <p>This example reprojects a raster to a different Coordinate Reference System (CRS). This example assumes a preloaded two-dimensional raster. For the loading part, diff --git a/howto/transform_coordinates.html b/howto/transform_coordinates.html index 2a8a053d..442ef1e3 100644 --- a/howto/transform_coordinates.html +++ b/howto/transform_coordinates.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Transform coordinates</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Transform coordinates</p> - + <p>The following Java code projects geographic coordinates from the <em>World Geodetic System 1984</em> (WGS84) to <em>WGS 84 / UTM zone 33N</em>. In order to make the example a little bit simpler, this code uses predefined constants given by the <code>CommonCRS</code> convenience class. But more advanced applications may use <a href="../epsg.html">EPSG codes</a> or definitions in Well-Known Text (WKT) instead.</p> diff --git a/howto/transform_envelopes.html b/howto/transform_envelopes.html index d0d22b59..6e73a66f 100644 --- a/howto/transform_envelopes.html +++ b/howto/transform_envelopes.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Transform envelopes (bounding boxes)</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Transform envelopes (bounding boxes)</p> - + <p>The transformation of envelopes (or bounding boxes) is a much more difficult task than transforming the four corners of a rectangle. The rectangle straight lines in source <abbr title="Coordinate Reference System">CRS</abbr> may become curves in the target <abbr title="Coordinate Reference System">CRS</abbr> diff --git a/howto/write_raster.html b/howto/write_raster.html index f483e307..f60a764f 100644 --- a/howto/write_raster.html +++ b/howto/write_raster.html @@ -1,7 +1,7 @@ <!DOCTYPE html> <html lang="en"> <head> - + <title>Apache SIS - Write a raster to a file</title> <meta charset="utf-8"> @@ -104,7 +104,7 @@ <article> <img src="../images/logo.png" class="sis-logo" align="left"/> <p class="page-title">Write a raster to a file</p> - + <p>This example saves a raster in PNG format. This example assumes a preloaded raster. For the loading part, diff --git a/index.html b/index.html index 27b8ea14..36c2c102 100644 --- a/index.html +++ b/index.html @@ -182,7 +182,7 @@ and more <a href="tables/CoordinateOperationMethods.html">supported operation me </ul> </details> <h2 id="user">Using Apache SIS </h2> -<p>The latest SIS release is 1.3, released December 2023, +<p>The latest SIS release is 1.3, released December 2022, and can be <a href="downloads.html">downloaded</a> as a <code>zip</code> files or as Maven dependencies. This is the latest version that can be run on Java 8 (next version will require Java 11). The EPSG geodetic dataset is optional for licensing reasons, but recommended. diff --git a/source.html b/source.html index 600f9402..d2403a68 100644 --- a/source.html +++ b/source.html @@ -129,7 +129,6 @@ or to cherry-pick only the interesting parts of the advanced configuration.</p> <li><a href="#branches">Switch to development branch </a></li> </ul> </li> - <li><a href="#netbeans">Opening Apache SIS in NetBeans </a></li> <li><a href="#history">History </a></li> </ul> </nav> @@ -257,23 +256,6 @@ Contributors to Apache <abbr title="Spatial Information System">SIS</abbr> proje </span></span><span class="line"><span class="cl">git checkout geoapi-4.0</span></span></code></pre></div> <p>Note that those <code>geoapi-xxx</code> branches may disappear or be replaced by something else after <abbr title="Open Geospatial Consortium">OGC</abbr> releases the corresponding GeoAPI versions.</p> -<h1 id="netbeans">Opening Apache SIS in NetBeans </h1> -<p>Apache <abbr title="Spatial Information System">SIS</abbr> build is defined by Maven <code>pom.xml</code> files. -All major IDE, including NetBeans, can open a project defined by those files. -However in the particular case of NetBeans IDE, we also provide a way to open Apache <abbr title="Spatial Information System">SIS</abbr> using Ant configuration files. -Compared to “Java with Maven” project, the “Java with Ant” project is faster to build and debug, -makes easier to see all modules at once, and provides more configuration options. -Those configuration files are available in the <code>ide-project/NetBeans</code> directory. -This project will fetch dependencies directly from the <code>.m2/repository</code> local directory, -and will refer to the resources <code>*.utf</code> files compiled by Maven in the <code>sis-*/target</code> directories. -Consequently it is important to run <code>mvn install</code> manually (on the command line) -before opening the project and after any change in the project dependencies or in the resources.</p> -<p>Users can customize their project configuration by editing the <code>ide-project/NetBeans/nbproject/private/config.properties</code> file. -The <code>private</code> directory is excluded by the versioning system, so it okay to put user-specific information there. -For example in order to overwrite the default location of the local Maven repository and to define a system property at execution time, -one can use:</p> -<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="na">maven.repository</span> <span class="o">=</span> <span class="s">/path/to/my/local/repository</span> -</span></span><span class="line"><span class="cl"><span class="na">run.jvmargs</span> <span class="o">=</span> <span class="s">-DmyProperty=myValue</span></span></span></code></pre></div> <h1 id="history">History </h1> <p>All developments and tags prior Apache <abbr title="Spatial Information System">SIS</abbr> 1.0 were done on a <a href="http://subversion.apache.org">Subversion</a> repository and can be <a href="http://svn.apache.org/viewvc/sis/">browsed online</a>. diff --git a/standards.html b/standards.html index 0ebb49c1..67fee56d 100644 --- a/standards.html +++ b/standards.html @@ -117,8 +117,8 @@ Some standards are implemented partially, others almost fully.</p> <table> <tr> <th><abbr title="International Organization for Standardization">ISO</abbr> standard</th> - <th><abbr title="Open Geospatial Consortium">OGC</abbr> / other</th> - <th>Upgrade needed</th> + <th>Other standard</th> + <th>Upgrade plan</th> <th>Title</th> </tr><tr> <td>ISO 19103:2015</td>