AGSi Standard / Model¶

Usage and schema overview¶

Usage¶

In an AGSi context, a agsiModel is a digital geometric (2D or 3D) representation of the ground.

The Model group (agsiModel) is used to define and assemble geometry based models. These models are built up from elements which are linked to geometry objects stored in the Geometry (agsiGeometry) group. Model elements may also be linked to data stored in the Data (agsiData) group.

There may be more than one model defined in an AGSi dataset (file).

For further information on what is considered to be a single model in an AGSi context, which includes guidance on how models can be divided up into subsets, please refer to Guidance on usage, Model - Overview.

Summary of schema¶

This diagram shows the objects in the Model group and their relationships.

Model summary UML diagram

A single model is defined by an agsiModel object. There may be several objects in a data set (file). Each agsiModel object contains objects from the classes described below.

The basic building blocks of each model are model elements. The model elements are defined as agsiModelElement objects. These elements are then collected together within the appropriate agsiModel object, i.e. agsiModelElement objects are embedded within the parent agsiModel object.

In addition, a model boundary may also be specified using an agsiModelBoundary object. Each model may contain only one agsiModelBoundary, which will be embedded within the parent agsiModel object.

Each model may optionally be divided up into model subsets. These subsets are defined using the agsiModelSubset object, which will be embedded within the parent agsiModel object. Subsets are then created by referencing the relevant agsiModelSubset identifier in the subsetID attribute of each agsiModelElement object.

Each model element can belong to no more than one subset.

Note

Use of subsets is optional. Some software may not be able to support subsets and therefore its use should be carefully considered by specifiers and modellers.

Schema UML diagram¶

This diagram shows the full schema of the Model group including all attributes.

Note

Reference links to other parts of the AGSi schema are not shown in this diagram.

Model full UML diagram