Issue 17055: Modify the comments in ContainQuery (tacsit-ftf)
Source: SimVentions (Mr. Matthew Wilson, mwilson(at)simventions.com)
Nature: Uncategorized Issue
Severity: Minor
Summary: Severity: Support Text

Summary:  The comments of this class reference state this:

Containment is determined by using the Entity's Geometry as an argument to the contains() method on the Geometry specified by this Query, i.e., this.satisfies( entity ) = this.getGeometry().contains( entity.getGeometry() )

This is not possible, however. The entity class has no “Geometry” in its interface.  If it were present, the Geometry interface does not provide enough information to evaluate such a query.

Resolution:
The Geometry class “contains” method accepts a GeodeticPosition, not a Geometry.  By adding the “getReferencePoint” method to entity (as proposed by issue XXXX) and modifying the comment on this method 

Change the comment to a more accurate description of how to use it.   For example:  Containment is determined by checking whether or not an entity’s reference point (GeodeticPosition) is contained within a specific Geometry, i.e. this.satisfies(entity) = this.getGeometry().contains(entity.getReferencePoint()).


Revised Text:
 Section 7.2.1.1 changed the description / comment for the method to
“Containment is determined by checking whether or not an entity’s reference point (GeodeticPosition) is contained within a specific Geometry, i.e. this.satisfies(entity) = this.getGeometry().contains(entity.getReferencePoint()).”

Resolution: 
Revised Text: 
Actions taken:
January 26, 2012: received issue
Discussion: 

End of Annotations:=====
s is issue # 17055


OMG Issue No:  17055

 
Title:   Modify the comments in ContainQuery
Source:
Matt Wilson - mwilson@simventions.com
 
Severity: Support Text
 

Summary:  The comments of this class reference state this:

 

Containment is determined by using the Entity's Geometry as an argument to the contains() method on the Geometry specified by this Query, i.e., this.satisfies( entity ) = this.getGeometry().contains( entity.getGeometry() )

 

This is not possible, however. The entity class has no .Geometry. in its interface.  If it were present, the Geometry interface does not provide enough information to evaluate such a query.
 
Resolution:
The Geometry class .contains. method accepts a GeodeticPosition, not a Geometry.  By adding the .getReferencePoint. method to entity (as proposed by issue XXXX) and modifying the comment on this method 

 

Change the comment to a more accurate description of how to use it.   For example:  Containment is determined by checking whether or not an entity.s reference point (GeodeticPosition) is contained within a specific Geometry, i.e. this.satisfies(entity) = this.getGeometry().contains(entity.getReferencePoint()).
 
 
Revised Text:
 Section 7.2.1.1 changed the description / comment for the method to
.Containment is determined by checking whether or not an entity.s reference point (GeodeticPosition) is contained within a specific Geometry, i.e. this.satisfies(entity) = this.getGeometry().contains(entity.getReferencePoint())..