resource_property_probability

Template:— resource_property_probability_numeric (res_prp_prob_num)

Date: 2008/03/07 09:36:31
Revision: 1.4

Cover Contents Description Model diags.Input params.Ref. params.Instantiation path Instance diags.Characterizations Issues

This section specifies the template resource_property_probability_numeric.

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

Description

This template describes how to represent a numerical probability for a resource property.

Model diagrams

The EXPRESS-G diagram in Figure 1 shows the templates and EXPRESS entities that are required to represent the template "resource_property_probability_numeric". The text highlighted in blue shows the template parameters.

Figure 1 — An EXPRESS-G representation of the Information model for resource_property_probability_numeric

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

Figure 2 — The graphical representation of the resource_property_probability_numeric template

Input parameters

The following input parameters are defined for this template:

value (Type= 'TYPE (any_number_value)' )

The value of the property. The datatype is always 'any_number_value' and should not be registered together with the value, i.e. enter the value as a number, without datatype.

class_name (Type='CLASS')

The class name of the probability in which the probability value is expressed.

The following classes and their sub-classes can be used:

classifications: "Probability_numeric" (urn:plcs:rdl:std:Probability_numeric)

class_ecl_id (Default=urn:plcs:rdl:std,Type='URN')

The identifier of the External_class_library storing the definition of the class referenced by the parameter @class_name.

context (Type='CLASS')

The name of the class being used to classify the representation context (Representation_context) of the property.

The following classes and their sub-classes can be used:

classifications: "Representation_context" (urn:plcs:rdl:std:Representation_context)

context_ecl_id (Default=urn:plcs:rdl:std,Type='URN')

The identifier of the External_class_library storing the definition of the class referenced by the parameter @context.

property (Type= 'ENTITY (Resource_property)' )

The target of the template, i.e. the Resource_property (or template assigning_resource_property) to which the Resource_property_representation is related.

Reference parameters

The following reference parameters are defined for this template:

prob_num(Type='ENTITY (Probability_numeric)')

Allow the Probability_numeric entity instantiated in this path to be referenced when this template is used.

Note: The Probability_numeric entity can be referenced in a template path by:

%^target = $resource_property_probability_numeric.prob_num%

where target is the parameter to which the Probability_numeric is bound.

prop_repr(Type='ENTITY (Resource_property_representation)')

Allow the Resource_property_representation entity instantiated in this path to be referenced when this template is used.

Note: The Resource_property_representation entity can be referenced in a template path by:

%^target = $resource_property_probability_numeric.prop_repr%

where target is the parameter to which the Resource_property_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 Reading Capability Templates help section.

Resource_property_representation

-- Mark the Resource_property_representation entity as
-- referable when this template is used by binding it to the reference
-- parameter ^prop_rep
%^prop_rep = Resource_property_representation%
Resource_property_representation.role = '/IGNORE'
Resource_property_representation.description = '/IGNORE'

-- Invocate the template representing_probability_numeric
/representing_probability_numeric(
    value= @value,
    class_name= @class_name,
    class_ecl_id= @class_ecl_id,
    context= @context,
    context_ecl_id= @context_ecl_id)/

-- Bind the Probability_numeric to the ^prob_num reference
%^prob_num = $representing_probability_numeric.prob_num%

-- Connect the Resource_property_representation to the input property and
-- to the numeric probability
^prop_rep.property -> @property
^prop_rep.rep -> ^prob_num

The following entities are instantiated with attributes as specified:

Entity in path	Value	Inherited from
Resource_property_representation.role	'/IGNORE'	—
Resource_property_representation.description	'/IGNORE'	—

Instance diagrams

The instance diagram in Figure 3 shows an example of the EXPRESS entities and templates that are instantiated by the template:

/resource_property_probability_numeric(value='0.15', property='#1', class_name='Normalized_numeric_probability', class_ecl_id='urn:plcs:rdl:sample', context='Probability_numeric', context_ecl_id='urn:plcs:rdl:sample')/

(an illustration of the consolidated resource_property_probability_numeric template is shown in Figure 4 below.)

Figure 3 — Entities instantiated by resource_property_probability_numeric template

The instance model in STEP ASCII exchange file format (ISO 10303 Part 21 syntax) is:


          #1 = RESOURCE_PROPERTY('/IGNORE','/IGNORE',$);
          #2 = RESOURCE_PROPERTY_REPRESENTATION('/IGNORE',#1,#4,'/IGNORE');
          #4 = PROBABILITY_NUMERIC('/IGNORE','/IGNORE','/IGNORE',#9,(#14));
          #6 = CLASSIFICATION_ASSIGNMENT(#7,(#4),'/IGNORE');
          #7 = EXTERNAL_CLASS('/NULL','Normalized_numeric_probability','/IGNORE',#8);
          #8 = EXTERNAL_CLASS_LIBRARY('urn:plcs:rdl:sample','/IGNORE');
          #9 = REPRESENTATION_CONTEXT('/IGNORE','/IGNORE');
          #11 = CLASSIFICATION_ASSIGNMENT(#12,(#9),'/IGNORE');
          #12 = EXTERNAL_CLASS('/NULL','Probability_numeric','/IGNORE',#8);
          #14 = PROBABILITY_NUMERIC_VALUE('/IGNORE',ANY_NUMBER_VALUE(0.15));

The instance diagram in Figure 4 shows the graphic symbol for the template that is to be used in other instance diagrams. The example template is:

Figure 4 — Instantiation of resource_property_probability_numeric template

Characterizations

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