|Compound Plane Angle Measure|
|Mesure composée d'angle plan|
IfcCompoundPlaneAngleMeasure is a compound measure of plane angle in degrees, minutes, seconds, and optionally millionth-seconds of arc.
NOTE IfcCompoundPlaneAngleMeasure is used where angles need to be described to an accuracy as fine as one millionth of a degree and expressed as parts of an arc. It may be used for angular measurement by surveyors or for other angular measurements where precision is required. Another usage is exact or approximate global positioning against a geographic coordinate systems using longitude and latitude.
NOTE While the unit of measurement of the type IfcPlaneAngleMeasure depends on unit assignment (radian or degree or other derived units; globally at the IfcPoject or locally at an IfcMeasureWithUnit), the units of IfcCompoundPlaneAngleMeasure are always degrees, minutes, seconds, and millionth-seconds irrespective of unit assignments.
HISTORY New type in IFC1.5.1.
Type: LIST [3:4] OF INTEGER
All measure components have the same sign (positive or negative). It is therefore trivial to convert between floating point representation (decimal degrees) and compound representation regardless whether the angle is greater or smaller than zero. Example:
a : IfcPlaneAngleMeasure := -50.975864; (* decimal degrees, -50° 58' 33" 110400 *)
b : IfcPlaneAngleMeasure;
c : IfcCompoundPlaneAngleMeasure;
s : IfcText;
(* convert from float to compound *)
c := a; -- -50
c := (a - c) * 60; -- -58
c := ((a - c) * 60 - c) * 60; -- -33
c := (((a - c) * 60 - c) * 60 - c) * 1.e6; -- -110400
(* convert from compound to float *)
b := c + c/60. + c/3600. + c/3600.e6; -- -50.975864
Use in string representations
When a compound plane angle measure is formatted for display or printout, the signs of the fractional components will usually be discarded because, to a human reader, the sign of the first component alone already indicates the sense of the angle:
(* convert from compound to human-readable string *)
s := FORMAT(c, '+##') + "000000B0"
+ FORMAT(ABS(c), '##') + ''''
+ FORMAT(ABS(c), '##') + '"'
+ FORMAT(ABS(c), '##'); -- -50° 58' 33" 110400
Another often encountered display format of latitudes and longitudes is to omit the signs and print N, S, E, W indicators instead, for example,
50°58'33"S. When stored as IfcCompoundPlaneAngleMeasure however, a compound plane angle measure is always signed, with same sign of all components.
|MinutesInRange||The second measure (minutes) shall be between -60 exclusive and 60 exclusive.|
|SecondsInRange||The third measure (seconds) shall be between -60 exclusive and 60 exclusive.|
|MicrosecondsInRange||The forth measure (millionth-seconds), if asserted, shall be between -1e6 exclusive and 1e6 exclusive.|
|ConsistentSign||All non-zero measure components shall have the same sign (positive or negative).|
<xs:attribute ref="ifc:itemType" fixed="xs:long"/>
<xs:attribute ref="ifc:cType" fixed="list"/>
<xs:attribute ref="ifc:arraySize" use="optional"/>
TYPE IfcCompoundPlaneAngleMeasure = LIST [3:4] OF INTEGER;
MinutesInRange : ABS(SELF) < 60
SecondsInRange : ABS(SELF) < 60
MicrosecondsInRange : (SIZEOF(SELF) = 3) OR (ABS(SELF) < 1000000)
ConsistentSign : ((SELF >= 0) AND (SELF >= 0) AND (SELF >= 0) AND ((SIZEOF(SELF) = 3) OR (SELF >= 0))) OR ((SELF <= 0) AND (SELF <= 0) AND (SELF <= 0) AND ((SIZEOF(SELF) = 3) OR (SELF <= 0)))