Class Name: Spatial Index Related Geometry

Superclass - Aggregate Geometry

Definition

An aggregation of Geometry Hierarchies in which each component Geometry Hierarchy represents a different tile within a spatially indexed (tiled) organization of Primitive Geometry objects within a SEDRIS transmittal. The Geometry Spatial Index Data link object attached to each component Geometry Hierarchy indicates the tile that it represents.

Primary Page in DRM Diagram:

Example

  1. See Spatial Index Related Organizing Principle, example #1.

  2. Consider an Environment Root describing a terrain surface that is a mix of grids and Polygons, organized by spatial indexing into 9 cells.

              -------------------
              |  A  |  B  |  C  |
              -------------------
              |  D  |  E  |  F  |
              -------------------
              |  G  |  H  |  I  |
              -------------------
    

    All cells except H are grids (represented in SEDRIS as Property Grids) captured at 1 level of detail. Cell H consists of Polygons.

    This would be represented as

                                <Environment Root>
                                        <>
                                        |
                                        |
                         <Spatial Index Related Geometry>
                                        <>
                                        |------- <GD Location 2D>
                                        |         (0,0)
                                        |
         -----------------------------------------------------------------
         |       |       |       |       |       |       |       |       |
         |-GSID  |-GSID  |-GSID  |-GSID  |-GSID  |-GSID  |-GSID  |-GSID  |-GSID
         | (1,1) | (1,2) | (1,3) | (2,1) | (2,2) | (2,3) | (3,1) | (3,2) | (3,3)
         |       |       |       |       |       |       |       |       |
         |       |       |       |       |       |       |       |       |
        PGHP   PGHP     PGHP    PGHP    PGHP    PGHP    PGHP    UoPG    PGHP
        (A)    (B)      (C)     (D)     (E)     (F)     (G)     (H)     (I)
    

    where the Spatial Index Related Geometry has row_count = 3 and column_count = 3, spacing_units = arc seconds.

    Please note that the components of the Spatial Index Related Geometry are not ordered; the Geometry Spatial Index Data is used to identify the individual tiles.

FAQs

What is the purpose of this class?
This class allows Geometries to be organized (tiled) according to some spatial index.
My data consists of terrain Polygons that are tiled along the lines of a grid, but some Polygons here and there cross over tile boundaries. Can I organize these Polygons with a Spatial Index Related Geometry?
Yes, if its strict_organizing_principle is set to SE_FALSE to indicate that the indexing is not strictly followed (see Spatial Index Related Organizing Principle, example #1). Each tile of the spatial index would be represented by a Geometry Hierarchy component of the Spatial Index Related Geometry.
Where is the origin of the spatial index?
The required Location component of the Spatial Index Related Geometry specifies the origin of the spatial index, which is its lower-left corner.

Constraints

Associated by (one-way)(inherited)

Associated with (two-way)(inherited)

Composed of (one-way)(inherited)

Composed of (one-way)

Composed of (two-way)(inherited)

Composed of (two-way)

Composed of (one-way metadata)(inherited)

Component of (two-way)(inherited)

Inherited Field Elements

SE_BOOLEAN unique_descendants; (notes)
SE_BOOLEAN independent_topologies; (notes)
SE_BOOLEAN strict_organizing_principle; (notes)

Field Elements

SE_BOOLEAN sparse; (notes)
SE_PINT32 column_count;
SE_PINT32 row_count;
SE_FLOAT64 column_width; (notes)
SE_FLOAT64 row_width; (notes)
SE_SPATIAL_INDEX_SPACING_UNITS_ENUM spacing_units;

Notes

Composed of Notes

Location

 The origin of the collection.  The lower-left corner.

Fields Notes

unique_descendants

 If SE_TRUE, then for any object that exists 'below' this aggregation,
 each object will appear in only one 'branch' of this aggregation.
 If SE_FALSE, then objects may appear in multiple 'branches' of this
 aggregation.

independent_topologies

 If SE_TRUE, then each 'branch' from this aggregation is its own,
 independent topology.  If SE_FALSE, then all of the branches exist
 within the same topology.

strict_organizing_principle

 If true, then each 'branch' strictly follows the rules of this
 aggregation.  If false, then each 'branch' might bend the rules a bit.
 For example, if this is a spatial aggregation, than a value of true
 indicates that objects will *not* cross the spatial extents defined
 by this aggregation relationship, and a value of false indicates
 that objects might cross those bounds.  For another example, if this
 is a time-based aggregation, then a value of true indicates that all
 branches will only contain data valid for the times specified for
 each branch, and a value of false indicates that the branches have
 the option of including data that falls outside of the specified
 time ranges for that branch.

sparse

 If SE_FALSE, then all column and row entries (all expected Geometry
 Hierarchy components) are present.  If SE_TRUE, one or more entries
 are not present.

column_width

 length of a cell in the given units along the X axis

row_width

 length of a cell in the given units along the Y axis

Prev: Spatial Index Related Features. Next: Spatial Reference Frame Summary. Up:Index.