[sis] 23/33: First draft of a GridCoverageResource interface.

[de...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git

commit a2f6e8e99d4880afa4d9e1153426d98a25b96008
Author: Martin Desruisseaux <de...@apache.org>
AuthorDate: Mon Jun 4 10:30:34 2018 +0000

    First draft of a GridCoverageResource interface.
    
    
    git-svn-id: https://svn.apache.org/repos/asf/sis/branches/JDK8@1832810 13f79535-47bb-0310-9956-ffa450edef68
---
 storage/sis-storage/pom.xml                        |  5 +++
 .../apache/sis/storage/GridCoverageResource.java   | 40 ++++++++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/storage/sis-storage/pom.xml b/storage/sis-storage/pom.xml
index e797afe..80d48eb 100644
--- a/storage/sis-storage/pom.xml
+++ b/storage/sis-storage/pom.xml
@@ -126,6 +126,11 @@
       <artifactId>sis-feature</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.apache.sis.core</groupId>
+      <artifactId>sis-raster</artifactId>
+      <version>${project.version}</version>
+    </dependency>
 
     <!-- Test dependencies -->
     <dependency>
diff --git a/storage/sis-storage/src/main/java/org/apache/sis/storage/GridCoverageResource.java b/storage/sis-storage/src/main/java/org/apache/sis/storage/GridCoverageResource.java
new file mode 100644
index 0000000..903c341
--- /dev/null
+++ b/storage/sis-storage/src/main/java/org/apache/sis/storage/GridCoverageResource.java
@@ -0,0 +1,40 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.sis.storage;
+
+import org.apache.sis.coverage.grid.GridGeometry;
+
+
+/**
+ * Access to data values in a <var>n</var>-dimensional grid.
+ * A coverage resource may be a member of {@link Aggregate} if a single file can provide many images.
+ *
+ * @author  Martin Desruisseaux (Geomatys)
+ * @version 1.0
+ * @since   1.0
+ * @module
+ */
+public interface GridCoverageResource extends Resource {
+    /**
+     * Returns the valid extent of grid coordinates together with the transform
+     * from those grid coordinates to real world coordinates.
+     *
+     * @return grid coordinates valid extent and their mapping to "real world" coordinates.
+     * @throws DataStoreException if an error occurred while reading definitions from the underlying data store.
+     */
+    GridGeometry getGridGeometry() throws DataStoreException;
+}