Template:— representing_grid_location (rep_grid_locn)
Capability:representing_location
Date: 2005/08/15 08:20:35 :
Revision: 1.7

This section specifies the template representing_grid_location.

NOTE  The template has been defined in the context of the capability representing_location which provides an overall description of the relevant parts of the ISO 10303-239 information model and a description of related templates.

NOTE  An explanation of a template and the associated instantiation path is provided in the Template overview section.

Description
This template describes the representation of a Regional_grid_location_representation. The most common form of local grids are those established by cartographers and superimposed on their maps. To provide an unambiguous identification, all partners must have access to the definition of the grid origin and orientation.
Model diagrams
The EXPRESS-G diagram in Figure  shows the templates and EXPRESS entities that are required to represent the template "representing_grid_location". The text highlighted in blue shows the template parameters.


Figure 1 —  

Figure 1 —  

The graphic for the template to be used in other EXPRESS-G diagrams is shown in Figure  below.


Figure 2 —  

Figure 2 —  

Input parameters
The following input parameters are defined for this template:
reg_grid_loc_id (Default=Uknown,Type='STRING')
The id of the Regional grid location representation
reg_grid_loc_type_code (Default=Regional_grid_location_identification_code,Type='CLASS', Optional)
The class name of the corresponding to the reg_grid_loc_id
The following classes and their sub-classes can be used:
classifications: "Regional_grid_location_identification_code" (urn:plcs:rdl:std:Regional_grid_location_identification_code)
reg_grid_loc_ecl_id (Default=urn:plcs:rdl:std,Type='URN', Optional)
The identifier of the External_class_library storing the definition of the class referenced by the parameter @address_class_name.
reg_grid_loc_name (Default=Unknown,Type='STRING', Optional)
The name commonly used to refer to the grid. Parameter is optional.
coord_siunit (Default=TRUE,Type='BOOLEAN')
Is the coordinate measured in SI Units (True/False)?
coord_unit_type (Default='radian',Type='CLASS', Optional)
The class name of the corresponding to the latitude and longitudinal units (radian or degree).
The following classes and their sub-classes can be used:
classifications: [radian]
[warning:]Error RDL1: The class radian does not exist in RDL at urn urn:plcs:rdl:std. Check the dexlib/data/refdata/rdl_index.xml
[degree]
[warning:]Error RDL1: The class degree does not exist in RDL at urn urn:plcs:rdl:std. Check the dexlib/data/refdata/rdl_index.xml
[Unknown]
[warning:]Error RDL1: The class Unknown does not exist in RDL at urn urn:plcs:rdl:std. Check the dexlib/data/refdata/rdl_index.xml
coord_val (Type= 'ENTITY (
[warning:]Error ER1: The entity PLANE_ANGLE_MEASURE does not exist
PLANE_ANGLE_MEASURE)'
[warning:]Error EXP-1: The EXPRESS entity PLANE_ANGLE_MEASURE
does not exist in data/schemas/ap239_arm_lf.xml.

)
The coordinate value
coord_type_ecl_id (Default=urn:plcs:rdl:std,Type='URN', Optional)
The identifier of the External_class_library storing the definition of the class referenced by the parameter @address_class_name.
coord_name (Default=Unknown,Type='STRING', Optional)
The name commonly used to refer to the grid. Parameter is optional.
Reference parameters
The following reference parameters are defined for this template:
reg_grid_loc_rep(Type='ENTITY (Regional_grid_location_representation)')
Allow the Regional_grid_location_representation entity instantiated in this path to be referenced when this template is used.
Note: The Regional_grid_location_representation entity can be referenced in a template path by:
%^target = $representing_grid_location.reg_grid_loc_rep%
where target is the parameter to which the Regional_grid_location_representation is bound.
Instantiation path
The instantiation path shown below specifies the entities that are to be instantiated by the template.
A description of templates and the syntax for the instantiation path is provided in the Templates Help/Information section.
-- Create the regional coordinate
Regional_coordinate

-- set local parameters
Regional_coordinate.name = '/IGNORE'

-- set the coordinate value
/representing_value_with_unit(
    unit_ecl_id=@coord_type_ecl_id,
    si_unit=@coord_siunit,
    value=@coord_val,
    unit=@coord_unit_type)/
%^coord_val = $representing_value_with_unit.item%
Regional_coordinate.coordinate_value -> ^coord_val
%^reg_coord = Regional_coordinate%

-- Assign the name to Regional_coordinate
/assigning_identification_with_no_organization(
    items=^reg_coord,
    id=@coord_name,
    id_class_name=Name,
    id_ecl_id=@coord_type_ecl_id)/

-- Instantiate a Regional_grid_location_representation
Regional_grid_location_representation

-- Set the local attributes to be ignored
Regional_grid_location_representation.description = '/IGNORE'
Regional_grid_location_representation.name = '/IGNORE'

-- Bind the Regional_grid_location_representation to the parameter ^reg_grid_loc_rep
-- The parameter is a reference parameter so the
-- entity can be referred to when this template is used.
%^reg_grid_loc_rep = Regional_grid_location_representation%

-- Assign identifier to Product_based_location_identification
/assigning_identification_with_no_organization(
    items=^reg_grid_loc_rep,
    id=@reg_grid_loc_id,
    id_class_name=@reg_grid_loc_type_code,
    id_ecl_id=@reg_grid_loc_ecl_id)/

-- Assign Name to Product_based_location_identification (assumes same urn and
/assigning_identification_with_no_organization(
    items=^reg_grid_loc_rep,
    id=@reg_grid_loc_name,
    id_class_name=Name,
    id_ecl_id=@reg_grid_loc_ecl_id)/

-- Name is an OWL class under identification_code
Regional_coordinate.grid_system -> Regional_grid_location_representation

-- end
The following entities are instantiated with attributes as specified:
Entity in path Value Inherited from
Regional_coordinate.name '/IGNORE'
Regional_grid_location_representation.description '/IGNORE'
Regional_grid_location_representation.name '/IGNORE'
Instance diagrams
The instance diagram in Figure  shows an example of the EXPRESS entities and templates that are instantiated by the template:


Figure 3 —  

Figure 3 —  

Characterizations
No common characterizations of the template representing_grid_location have been identified. However, the ISO 10303-239 EXPRESS model may enable other assignments to the entities instantiated by the template.

© OASIS 2010 — All rights reserved