Project

General

Profile

Actions

Bug #3541

closed

clarify documentation on polygons and grings, indicate relationship to FGDC

Added by Margaret O'Brien over 15 years ago. Updated over 15 years ago.

Status:
Resolved
Priority:
Normal
Assignee:
Category:
eml - general bugs
Target version:
Start date:
10/21/2008
Due date:
% Done:

0%

Estimated time:
Bugzilla-Id:
3541

Description

The documentation in this section is sparse. The NEON project is currently evaluating EML, and has pointed out a discrepancy between FGDC and EML which should be either explained or the 2 specifications should agree.

FGDC: types that are equivalent to "datasetGPolygonOuterGRing" and "datasetGPolygonExclusionGRing" require a minimum of 4 points for polygons
EML: a) datasetGPolygonOuterGRing: requires 3 minimum, and b) datasetGPolygonExclusionGRing requires 1.
Reasoning: a) FGDC documentation states that a polygon needs to have 4 points, and the first and last should be identical. However, XMLSchema does not have a way to enforce this. So EML requires only 3, and the 4th is implied.
b) allowing the exclusionRing to have only one point means that a single point can be excluded, presumably, a single station.

EML's documentation for datasetGPolygonOuterGRing should make this clear. It also could recommend that xsl stylesheets that transform EML to FGDC should repeat the first lat/lon pair as the last when creating a list of points.

the alternative to both datasetGPolygonOuterGRing and datasetGPolygonExclusionGRing is gRingType, which is a string of ordered pairs. Presumably, this was supposed to be a field that could be directly translated to FGDC. If so, the documentation should state this, and recommended that a minimum of 4 pairs be included. However, if this field remains an unrestricted string, this is not enforceable with xmlschema.

Actions #1

Updated by Margaret O'Brien over 15 years ago

checked in the documentation, with r1.89

Actions #2

Updated by Redmine Admin about 11 years ago

Original Bugzilla ID was 3541

Actions

Also available in: Atom PDF