Hello all

There were talk recently about Coverage on both GeoAPI and GeoTools list, so I 
take this opportunity to clarify a situation and anounce what may be a future 
change.

Why org.opengis.coverage.grid.GridRange has been deprecated
-----------------------------------------------------------
GridRange was defined in legacy OGC 01-004 specification. It has been replaced 
in ISO 19123 by GridEnvelope, which serve the same purpose. We could have keep 
the "GridRange" name for compatibility with legacy applications. The problem is 
that the word "range" has a very different meaning in ISO 19123 than it had in 
OGC 01-004. ISO defines the range of a coverage as the set of feature attribute 
values that can be returned by the "evaluate(DirectPosition)" method. Coverage 
methods like "getRangeType()" and "getRangeElements()" (defined by ISO) use 
this 
definition. On the OGC WCS mailing list, I'm reading emails using "grid range" 
in the sense of "the set of all possible pixel values".

In this context the interface name "GridRange" inherited from the legacy 
specification was clearly problematic. This kind of problem has been detected 
years ago and the legacy interfaces flagged with big warning in their javadoc 
anouncing that they will change or be removed.


What need to be changed
-----------------------------------------------------------
For the reason explained above, the GridGeometry.getGridRange() method name is 
problematic because the returned value is absolutly not a grid range according 
ISO 19123. It would not be a big issue if the name "grid range" was not used 
for 
something else (so they would be no confusion), but in the context of ISO 19123 
it is.

No action on the method name has been taked so far because we have not yet 
investigated how the legacy GridGeometry interface could be integrated with the 
ISO 19123 interfaces and what should be preserved. The getGridRange() method is 
replaced by Grid.getExtent() in ISO, but I think that at least getGridToCRS() 
needs to be preserved.

In the mean time, GridGeometry still flagged as an interface that need 
revision. 
Please note the big warning box which exists since 2005:

http://geoapi.sourceforge.net/snapshot/pending/org/opengis/coverage/grid/GridGeometry.html

        Martin

P.S.: I'm registered on the geotools mailing list only in "digest" mode. Since 
this topic is about GeoAPI interfaces, if there is a wish to make technical 
discussion about what may be changed, when and how to do the transition, I 
suggest to use the GeoAPI mailing list.

------------------------------------------------------------------------------
Crystal Reports - New Free Runtime and 30 Day Trial
Check out the new simplified licensing option that enables 
unlimited royalty-free distribution of the report engine 
for externally facing server and web deployment. 
http://p.sf.net/sfu/businessobjects
_______________________________________________
Geotools-devel mailing list
Geotools-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geotools-devel

Reply via email to