The OCL expression related to the BinaryMeasurement Class refers to the context RatioMeasurement instead of BinaryMeasurement.

Context of OCL expression of BinnaryMeasurement was fixed already

The context of the OCL expression of BinaryMeasurement was already fixed in SMM 1.1, due to resolution of other issue(s).

The operation attribute is declared to be of type Operation while this type is not specified in the document. Moreover, e.g. in Figure 5, it is declared to be of type string.

Operation association has been fixed in SMM 1.1 already

Section 10.7 of SMM 1.1 defines Operation Class. Figure 5 and other references to Operation have been fixed too. These fixes have been applied due to resolution of other issues at that time.

Scales of Measurement are a fundamental property of a Measure describing the allowable mathematical transformations that can be legitimately applied to it.
Attached are some URLs that will give you an overview of Scales of Measurement. Since they therefore determine the statistical methods that can be applied to the Measure, they need to be treated as a first level attribute of a Measure.
http://www.math.sfu.ca/~cschwarz/Stat-301/Handouts/node5.html
http://en.wikipedia.org/wiki/Scale_of_measurement (not always written in easily understood terms)
http://www.wadsworth.com/psychology_d/templates/student_resources/workshops/stat_workshp/scale/scale_01.html (tutorial - behavioral science view)
It is proposed to introduce an Enumeration to define the possible Scales of Measurement: ordinal, nominal, interval and ratio. Also to add an attribute to Measure, to define its scale.

Scale of Measurement was implemented already

Scale of Measurement has already been implemented in SMM 1.1.

Comparing the specification and the provided meta model, numerous inconsistencies between both appear. For example:
• Naming differentials: Most of the meta classes with an underscore in their name mentioned in the specification document are named differently without the underscore.
• Some association ends are missing in the provided model, e.g. categoryElement for the association between SMMCategory and Measure. (In our opinion, this association should be called measureElement to separate from the reflexive Association of the SMMCategory class having the same name.)
• Numerous multiplicity values in the meta model differ from the specification. For example, the association between the SMMModell class and the SMMElement class has the upper bound value 1.
• The subclasses of CollectiveMeasure (AdditiveMeasure and MaximumMeasure) mentioned in the specification do not occur in the meta model.

Inconsistencies between meta-model and specification have been fixed in SMM 1.1

These inconsistencies between meta-model and specification have already been fixed in SMM 1.1, due to resolution of other issues. E.g., in SMM 1.1, names no longer have underscores, all association ends are provided in the model, and multiplicity issues have been fixed. All classes and sub-classes appear in the model.

In some cases, it is helpful to compose several measures to a single audit to run these measures at once without the necessity to select the individual measures manually prior to each computation. Although it would be possible to model such as relationship using a subclass of the MeasureRelationship class, we recommend to introduce a class Audit that simply has an association to the Measure class to model the membership of a measure to a specific audit.

No change needed

The ObservedMeasure Class was introduced to SMM after publication of ptc/09-03-03 and that Class composes a collection of Measurements of one or more Measures, but of a single Observation. The ObservedMeasure Class, as such, fulfills the features of the requested Audit Class.

SMM confuses "To" and "From". There are two points of inconvenience (or even confusion ?) related to measure(ment) relationship: 1) Consider RescaledMeasure(ment) ("RSC") on one hand and BinaryMeasure(ment) ("BIN"), CollectiveMeasure(ment) ("COL"), RankingMeasure(ment) ("RNK") and GradeMeasure(ment) ("GRD") on the other hand. They all aggregate "from" a DimensionalMeasure(ment) ("DIM"). However, RSC looks to DIM as "from", whereas BIN, COL, RNK and GRD all look at DIM as "to". Isn't that confusing ? Is it inconsistent ? Or is there a good reason for it ? 2) When I think of aggregating from DIM (regardless of whether I do that by rescaling, or binary functor or accumulation or grading or ranking), I always think of aggregating "from" a DIM and "to" an aggregated one (RSC, BIN, COL, RNK, GRD). The “from” association of all SmmRelationship is defined as the origin element and the “to” association is defined as the target element which implies that the associations between BIN, COL, RNK and GRD to DIM are backwards. The “from” should in each case be the DIM measure(ment)s and the “to” should be the aggregating measure(ment)s.

Defer changes of "To" and "From" in MeasureRelationships

Further discussion learned that there might be good reasons why SMM 1.0 did it the way it was done, and that the deviating “from/to” naming of RescaledMeasure maybe on purpose. As the final conclusion of this was not reached yet, and as changing this would have quite some impact, it was decided to defer to issue.

Add a non-normative clause to the SMM document which demonstrates a SMM library of basic unit conversions including currency conversion.

Defer Library of Unit conversions

This will potentially be useful, though it is not critical at this moment. Given the scope of the current RTF, it was agreed to defer it. Possibly to, potentially, SMM 2.0.

The chosen way of modeling names for model elements is not done straightforward and hampers the practical usage of the meta model. The SMM meta model contains several classes having an attribute called name. Moreover, all meta classes are derived from the abstract meta class SMM_Element, which should possess such an attribute according to the specification. Hence, this attribute can be considered of being modeled redundantly.
Regarding the provided EMOF model, the SMM_Element does not have any attribute so that the specified attributes name, short_description and description are missing.

According to best practices, we recommend to introduce a new class called SMM_NamedElement as a subclass of SMM_Element and as the base class of all meta classes having a name attribute. This facilitates to determine the name of a model element.

Issue is subsumed in issue SMM12-92

This issue is subsumed in issue SMM12-92

It is not stated clear how to assign threshold values to dimensional measures. On page 9 of the specification document, it is mentioned that a measure has a range which can be interpreted as “the set of possible measurement results”. However, there is no corresponding attribute mentioned in the specification or meta model.

We suggest to add two attributes lowerThreshold and upperThreshold to the DimensionalMeasure meta class to model a measure’s range.

Remove "range"

Modify the third paragraph of Sub-clause 10.1 (General) of Clause 10 (Measures), to delete the phrase "; a range, the set of possible measurement results;".

In 10.3 Scope::class should not be a String but a proper reference to MOF:Class (which will be serialized as a XMI href). Relying on ‘name’ and a linking convention unique to this standard, makes practical linking and resolution unworkable

Replace String as type of class attribute with MOF::Class.

The UML uses non-standard notation by showing the superclass in top right of a class compartment.

Replace diagrams to not show superclass

The metamodel is missing Properties for important navigable relationships: for example the owner of a MeasureRelationship, the child of a Characteristic, the Measures for a Characteristic, the applicability of an Operation and more

Modified model to add names as needed

The UML uses ‘string’ lowercase rather than the UML/MOF PromitiveType String (uppercase)

Replace UML/MOF PrimitiveType String by string (lowercase) in document

8.7, 8.8: it should be made clear that Date and Timestamp are PrimitiveTypes

Add a note to 8.8 and 8.9 that each is a primitive type.

This issue deals with the fact that the SMM didn’t provide any real root class in its model and that everything started with SmmElement.

Discussion:
The architecture board as recommended that we add a new root class that can be used as the direct extension for attribute and annotation. In turn, SmmModel and SmmRelationship also now extends this new Element class.

Summary of change:
• Add Element class, a model root class
• Modify SmmElement class
o Change from model root class to class being a generalization of Element
• Modify SmmModel class
o Change generalization from SmmElement to Element
• Modify SmmRelationship class
o Change generalization from SmmElement to Element
• Modify Attribute class
o Change generalization from SmmElement to Element
• Modify Annotation class
o Change generalization from SmmElement to Element

• Create new separate diagram for Core

• Re-arranged content of Chapter 8 and Chapter 9 of Specification
o Renamed chapter 8 to “Core Base Classes”
o Move Figure 2 Core Classes Diagram to Figure 3 and rename to Metrics Core Classes
o Move Figure 3 Core Relationship Classes to Figure 4
o Insert Core Classes from above to Figure 2
o Add following description for Element class under 8.1:
Element Class (Abstract)
An Element constitutes an atomic constituent of a model. In the meta-model, Element is the top class in the hierarchy. Element is an abstract class.
Semantics
Element is the common parent from all meta-model elements of SMM. Most subclasses of Element can own annotations and user-defined attributes through standard extension mechanisms.

o Added Superclass info to SmmElement
o Modified Superclass info of SmmModel from SmmElement to Element
o Modified Superclass info of SmmRelationship from SmmElement to Element
o In chapter 9, remove the figure that only depicted the extensions, now shown in figure 2 as seen above.
o Added chapter 10 as “Core Metrics Classes”
o Moved description of class MeasureLibrary from chapter 8 to 10
o Moved description of class MeasureCategory from chapter 8 to 10
o Moved description of class CategoryRelationship from chapter 8 to 10

Discussion:
Rejecting keeps SMM more aligned with the design used in KDM and VDML.
Disposition: Closed, no change

Section 9: It does not make sense for Attribute or Annotation to inherit from SmmElement: they will not have or need their own name, description or Attributes/Annotations: in fact the latter is explicitly disallowed – though only informally in the text.

Rejecting keeps SMM more aligned with the design used in KDM and VDML.
Disposition: Closed, no change

Add attribute “type” (String) to Observation. Examples of observation type values are “estimated”, “actual”, "simulated", "benchmark".

Discussion:
VDML Analysis Context associates with SMM Observation (e.g. different Observation in different Context). We can consider to close this SMM issue by doing nothing in SMM, and rather have a type attribute on the Context class in VDML.
Disposition: Closed, no change

OMG Issue No: 15857
Title: Add relation to Scope Class
Source: Frédéric Madiot, MIA Soft,

Summary:
This issue addresses a lack of navigability in scopes.

Discussion:
Here are our modifications of SMM beta 2 specification:
Class Scope
we have added 2 references :
• a “non containment” reference called 'parent', type Scope (0..1), to link a scope to its parent.
• a “non containment” reference called 'children', type Scope (0..*), to link a scope to its children.

Summary of change:
• Add a new relation to Scope class:

o In the documentation for Scope, in the Associations sub-section, add the following new element:
children: Scope[0..*] Specifies the parent scope of this scope.
parent: Scope [0..*] Specifies the children scopes of this scope.

Discussion:
Reason for rejection: Scopes are sets and do not have a single inherent hierarchy.
Disposition: Closed, no change

Source: OMG AB

Summary:
This issue addresses a relation that in the diagram that was not documented in the specification.

Discussion:
The architecture board as recommended that we add the necessary documentation change to describe a missing containment relation in the specification.

Summary of change:
• In the documentation for SmmElement, in the Associations sub-section, add the following new element:
ownedRelation:SmmRelationship[0..*] Primitive SMM relationships that originate from the current SmmElement.

Discussion:
Containment at this level of abstraction (SmmElement is so broad, and so is SmmRelationship) is not meaningful. Even when one would want it, it should then be properly defined via properties that are derived unions, based on properties (at specialized level) that are their subsets. The association is very under-defined in the meta-model. It did not even have names for its ends. Hence the inconsistency has better be resolved the other way round: by removing the association from the meta-model also. This is done per resolution of issue 19602.
Disposition: Closed, no change

Please add another issue to the SMM RTF: Remove the TimeStamp primitive type

The TimeStamp primitive type is not used at any point in SMM and it should be, consequentially, be removed.

Discussion:
Superseded by issue 19704.
Disposition: Closed, no change

According to the SMM spec, a RescaledMeasure can rescale from 0..* binary measures, and a RescaledMeasurement can rescale from 0..* binary measurements accordingly.
This is strange however. It is unclear how rescaling is possible from more than 1 simultaneously. Seems that the multiplicity should be 1 instead of 0..*.

Discussion:
The Summary suggests that not only the “” in the multiplicity of RescaledMeasurement.rescaleFrom is wrong, but the “” in the multiplicity of RescaledMeasure.rescaleFrom as well. This is incorrect. It should still be possible that a RescaledMeasure has multiple rescaleFrom relationships. Hence issue 19718 was created afterwards, superseding 17504.
Disposition: Closed, no change

Allow more normative options for language of operation body. Allow at least JSON, to be able to express operations in url format

Discussion:
Issue 19408 provides a better solution. Also, JSON is not a query language and would be inappropriate in any case.
Disposition: Closed, no change

The metamodel defines MOF operations for derived Properties – this is redundant and as unnecessary as defining getters and setters for normal Properties. For example SmmRelationship::getFrom()

Disposition: See issue 19721 for disposition

Section 8.6, measureCategory, has an OCL constraint

context CategoryRelationship inv:

to.oclIsTypeOf(MeasureCategory) or

measures.oclIsTypeOf(Measure)

The last line is incorrect and should be to.oclIsTypeOf(Measure). However this is IMHO bad practice and there should be a more specific association than using AbstractMeasureElement

Disposition: See issue 15855 for disposition

What is missing however is any semi-formal description of how the properties are derived – for example OCL

Disposition: See issue 19722 for disposition

Source: OMG AB

Summary:
This issue deals with the fact that the SMM didn’t take advantage of some of the provision of CMOF.

Discussion:
The architecture board as recommended that we change the SMM specification to be more in-line with CMOF rather than restricting ourselves to the EMOF model.

Summary of change:
• Modify SmmElement class
o Remove operations section from SmmElement
• Modify SmmRelationship class
o Remove derived union attribute from the from and to associations.
o In the documentation, in the Associations sub-section, update the content to remove the reference to derived union:
from:SmmElement[1] The origin element (also referred to as the from-endpoint of the relationship).
to:SmmElement[1] The target element (also referred to as the to-endpoint of the relationship).

• Modify MeasureRelationship class
o Remove derived union attribute from the from and to associations.
o In the documentation, in the Associations sub-section, update the content to remove the reference to derived union:
from:Measure [1] The origin element (also referred to as the from-endpoint of the relationship).
to:Measure [1] The target element (also referred to as the to-endpoint of the relationship).

• Modify MeasurementRelationship class
o Remove derived union attribute from the from and to associations.
o In the documentation, add the Associations sub-section (was missing), with the following content:
Associations
from:Measurement [1] The origin element (also referred to as the from-endpoint of the relationship).
to:Measurement[1] The target element (also referred to as the to-endpoint of the relationship).

Disposition: See issue 17212 for disposition

In SMM spec the examples (instance models) have "AdditiveMeasure". But that is not existing in the spec (meta-model). I guess it is an oversight, and it should be CollectiveMeasure?

Disposition: See issues 19450, 19609 and 19610 for disposition

Examples (instance models) in SMM spec suggest that rescaled measure has "operation", but the meta-model has "formula". This is probably an oversight ?

Disposition: See issues 19450, 19609 and 19610 for disposition

Add a non-normative clause to the SMM doc which demonstrates a SMM library of basic unit conversions including currency conversion.

This will potentially be useful, though it is not critical at this moment. Given the scope of the current RTF, it was agreed to defer it to a next RTF.

Summary:
This issue addresses a wording problem with the compliance requirement.

Discussion:
The architecture board as recommended that we change the compliance condition from “can” to “must”.

Summary of change:
• In section 2, change “An implementation can provide “ to “An implementation must provide “

In Clause 2, change “An implementation can provide “ to “An implementation must provide“. Similar problem is fixed in a few constraints

Please add another issue to the SMM RTF: SMM confuses "To" and "From"

There are two points of inconvenience (or even confusion ?) related to measure(ment) relationship:

1) Consider RescaledMeasure(ment) ("RSC") on one hand and BinaryMeasure(ment) ("BIN"), CollectiveMeasure(ment) ("COL"), RankingMeasure(ment) ("RNK") and GradeMeasure(ment) ("GRD") on the other hand.

They all aggregate "from" a DimensionalMeasure(ment) ("DIM").

However, RSC looks to DIM as "from", whereas BIN, COL, RNK and GRD all look at DIM as "to".

Isn't that confusing ? Is it inconsistent ? Or is there a good reason for it ?

2) When I think of aggregating from DIM (regardless of whether I do that by rescaling, or binary functor or accumulation or grading or ranking), I always think from aggregating "from" a DIM and "to" an aggregated one (RSC, BIN, COL, RNK, GRD).

The “from” association of all SmmRelationship is defined as the origin element and the “to” association is defined as the target element which implies that the associations between BIN, COL, RNK and GRD to DIM are backwards. The “from” should in each case be the DIM measure(ment)s and the “to” should be the aggregating measure(ment)s.

Further discussion learned that there might be good reasons why SMM 1.0 did it the way it was done, and that the deviating “from/to” naming of RescaledMeasure maybe on purpose. As the final conclusion of this was not reached yet, and as changing this would have quite some impact, it was decided to defer to issue.

SMM 1.0 assumed EMOF, which is limited. CMOF should be used instead. This issue supersedes 15856, because that issue was earlier balloted with a resolution that was irrelevant to “EMOF versus CMOF” and even unwanted.

Disposition: See issue 17212 for disposition

Make all examples shown in the non-normative clauses of the SMM doc compatible with the latest SMM spec

Disposition: See issues 19609 and 19610 for disposition

Examples (instance diagrams) in SMM spec contain AdditiveMeasure and AggregatedMeasure.
I think that the meta-model suggests that these don't exist (anymore ?), as there's only CollectiveMeasure

Disposition: See issues 19450, 19609 and 19610 for disposition

In examples/instances of rescaled measures in SMM spec, there is sometimes reference (from formula string) to "baseMeasure". But that is wrong, as according to the meta-model, a rescaled measure does not have “base measure”, but “rescale from” ?

Disposition: See issues 19450, 19609 and 19610 for disposition

In SMM spec, there's this text, for RescaledMeasure:

Associations:

baseMeasure:DimensionalMeasure: Identifies the measure applied to each “contained” entity to determine base measurements.

rescaleFrom:RescaledMeasureRelationship[0..*]: Specifies the relationship instance that defines the measure rescaled by this rescaled measure.

However: the meta-model diagram suggests that there is only rescaleFrom. No baseMeasure.

This is wrong.

Disposition: See issue 19717 for disposition

Add the following attributes to Measurement, to enable expression of measurement precision, and stochastic aspects of measurements: “confidence interval upper bound”, “confidence interval lower bound”, “confidence” (being a probability) and “distribution”(string).

The RTF discussed this issue (at length) and found a resolution which addressed the core concern within the issue while preserving the general design pattern of SMM. The following was considered to further accommodate stochastic measurement:
• Stochastic measurement (e.g. in the context of simulation) usually comes with large sets of Measurements. SMM does already support that a large set of Measurements is “summarized”. Example: 10000 Measurements are the basis for a CollectiveMeasurement (which expresses the mean or some other accumulation). For scalability reasons there should still be a way to reach out to the large set of Measurements, without populating these Measurements in the model itself. Leaving the base Measurements out of the model is already possible via value “false” for attribute “isBaseSupplied” of a CollectiveMeasurement. Reaching out to the (external) base Measurements can be facilitated by an additional association “baseQuery” (analogous to defaultQuery).
• To take stochastic Measurements based on SMM, a separate Measure would be defined, whereby stochastic methods may implemented via Operation of the Measure. In SMM, Arguments of an Observation serve as parameters to the Operation. In order to be able to vary stochastic parameters within an Observation, Arguments can, additionally, be associated with ObservedMeasure. This will give a practical and SMM-compliant way to handle Operation parameters, both stochastic parameters and parameters in general.
Hence, resolution is twofold:
• Both Observation and ObservedMeasure can have Arguments associated.
• Add baseQuery to non-direct Measurement, whereby baseQuery is an Operation that specifies a query that can used to determine the base measurements of a non-direct Measurement when isBaseSupplied = false. baseQuery is optional even when isBaseSupplied = false and isBaseSupplied is inapplicable when isBaseSupplied = true. baseQuery and defaultQuery should not create inconsistencies. Directly supplied base Measurements would always have precedence. baseQuery would have secondary precedence and defaultQuery has the lowest precedence. The two queries then present two different ways of cutting off the supplied Measurements. defaultQuery allows a user to cut off base Measurements of Measurements of a given Measure. baseQuery allows a user to cut off the base Measurements of a given non-direct Measurement.

The measurand of Measurement, which references Element (MOF), is owned by Measurement. It should instead be owned by the association between Measurement and Element. This means that metamodels, such as VDML, extending SMM are able to create their own more specialized associations to restrict the measurand to be typed by metaclasses in their own metamodel. Otherwise they will need to specialize Measurement (SMM) itself – and, what is so awkward, specialize all the subclasses of Measurement (e.g. via multiple inheritance). By specializing only the association they can reuse the SMM Measurement class and all its SMM subclasses with no change. The root constraint underlying all the above is that MOF/UML requires any redefined property to be owned by a classifier that is a generalization of the one owning the redefining property. Note that both associations and classes are classifiers. More specifically, to be able to state that C1:p1

then C2 must be a supertype of C1 (directly or indirectly).

The measurand of Measurement, which references Element (MOF), should instead be owned by the association between Measurement and Element. This means that metamodels, such as VDML, extending SMM are able to create their own more specialized associations to restrict the measurand to be typed by metaclasses in their own metamodel. By specializing only the association they can reuse the SMM Measurement class and all its SMM subclasses with no change.
The root constraint underlying all the above is that MOF/UML requires any redefined property to be owned by a classifier that is a generalization of the one owning the redefining property. Note that both associations and classes are classifiers. More specifically, to be able to state that C1:p1

then C2 must be a supertype of C1 (directly or indirectly).

SMM metamodel contains class "MofElement". It's name is not precisely identifying the Element class in MOF (or CMOF), and the XMI file might not contain the precise reference either. SMM should create a small metamodel package "MOF" (or CMOF), containing at least "Element". And refer to it as measurand, from SMM, instead of having the MOF Element class in the SMM package itself. In addition to that, the XMI file should contain the correct reference (href) to Element

SMM should create a small metamodel package "MOF" (or CMOF), containing at least "Element". And refer to it as measurand, from SMM, instead of having the MOF Element class in the SMM package itself. In addition to that, the XMI file should contain the correct reference (href) to Element

The following changes have been submitted and are pending with the SMM (Structured Metrics
Metamodel) RTF.

Scope of a measure should be made optional.

Keep scope required. Add two new attributes, name and description. Add a new constraint that requires that either the class attribute is given or that both the name and description attributes are given. In the spec, give as example: Area of a square; no class named “square”. Binary Measure with “area” as trait (maybe “size” as parent of “area”), “times” as functor, Base Measure1 being Side1 Length and Base Measure2 being Side2 Length. Scope with “Square” as name, and “2 dimensional closed object with 4 equal length sides” as description.

SMM should use MOF 2.4.1.

This makes it easier to create the metamodel (the UML model can be used largely as-is) and is required for compatibility with VDML which is dependent on SMM.

Export UML 2.4.1 XMI from Enterprise Architect (the source tool as used for SMM 1.0), which will retain the SMM diagrams going forward and allow inclusion of the other fixes (it covers issue 19720, as SMM 1.1 will use CMOF, and does e.g. enable resolution of issue 17471).
As part of this, and the correct application of CMOF for meta-modeling, according to MOF 2.4.1, name any unnamed property or association in the model, and for any property that has visibility “private”, change it to visibility “public”. Also, name any unnamed operation return parameter in the model, provide return parameter type where omitted, and for any such parameter that has visibility “private”, change it to visibility “public”.

Source: OMG AB

Summary:
This issue addresses an incorrect constraint on a relation.

Discussion:
The architecture board as recommended that we correct the relation constraint in CategoryRelationship as it did not accurate.

Summary of change:
• In the documentation for CategoryRelationship, in the Constraints sub-section, change the content to now read:
context CategoryRelationship inv:
to.oclIsTypeOf(MeasureCategory) or
to.oclIsTypeOf(Measure)

Reference to association end “measures” should be replaced with reference to “to”.

Source: OMG AB

Summary:
This issue deals with the fact that XQuery is not defined and it’s mapping to XMI is also not well defined.

Discussion:
The architecture board as recommended that we clarify the mapping of XQuery to XMI and identify the versions in use.

Summary of change:
• In section 3, “Normative References”, add the following:
o OCL 2.2 Specification
o XQuery 1.0, XPath 2.0 (W3C Recommendation)
• In section 7, “SMM” at the end of the section add the following:
In a number of places, SMM supports querying or constraining data of interest by specifying some queries. Such queries can be expressed either with OCL version 2.2 as published by the OMG, or with XQuery 1.0 as published by the W3C. For XQuery, SMM uses a variant of XPath 2.0 (part of XQuery 1.0) and maps it to XMI using the following rules:
• XPath uses a path expression where each path is a series of steps separated by forward slashes .
• The steps are evaluated from left to right, and generally decend the model's tree as they do so
• Each step identifies tree nodes by their classifier name and attributes are specified, just as in XPath with a leading @.
SMM implementations are encouraged to implement OCL and XQuery by providing a wrapper that exposes their models to 3rd party query engines that implement all of the complexities of those languages.

Resolution given in issue statement

Allow multiple operations for a direct measure (multiplicity 0..*). In addition add attribute “type” (String) to DirectMeasure. When “type” is filled, it corresponds to observation type

The RTF discussed this issue (at length) and found a resolution which addressed the core concern within the issue while preserving the general design pattern of SMM. The following was considered to further variations of Operation:
• Instead of one Measure with multiple Operations, it fits SMM better to use multiple Measures, each with one Operation, and all for the same Charactersitic (trait).
• These multiple Measures might be stored in a MeasureLibrary of structured Measures, and might be the operational counterparts of a less structured or informal Measure (typically a NamedMeasure) in another MeasureLibrary. That informal Measure might be referenced by the others as their “source” (for traceability reasons). A “source” attribute might be added to Measure to support this. This will also generally enable Measure maintenance, whereby e.g. a library of informal Measures, possibly obtained as standard industry Measures, are worked into multiple more structured (and operational) Measures in other MeasureLibraries.
Hence, the resolution is to add “source” (string) as property to Measure.

Assume that you have 5 measurements (according to their measures), and that you just want to multiple the results of all 5: result 1 * result 2 * result 3 * result 4 * result 5.

This can be done in SMM as follows:
1) 4 binary measures, with functor "times" , or
2) 4 rescaled measures, with formula " * baseMeasurement"

But wouldn't it be very handy to just have 1 collective measure, whereby accumulator would be “product” ?
Currently the accumulators are just "sum", "max", "min", "avarage" and "stdv".

Proposal: Add accumulator value “product”.

Add enumeration value “product” to Accumulator

In CollectiveMeasurement class:

Text says:
Associations:

baseMeasurement:DimensionalMeasurement[0..*]: Identifies the measurements from which this collective measurement was derived.

However: the meta-model suggests that there's baseMeasurementTo. Not baseMeasurement.

So, the associations text is wrong.

In CollectiveMeasurement class, replace Association “baseMeasurement:DimensionalMeasurement [0..*], Identifies the measurements from which this collective measurement was derived”, with “baseMeasurementTo:BaseMeasurementRelationship [0..*], Specifies the relationship instance that defines the accumulation for this measurement”.
Similar problem should also be fixed in a few other places.

In SMM, a binary measure has a functor.
Examples in the spec (instance models) suggest functor values like “sum”, “difference”, “times”, “divide”.
This sounds like functor should have an enumeration defined in the spec, like also accumulator has for a collective measure.
However, SMM does not do that for functor. Why not? It is rather similar (see also that accumulator has a value “sum” ..).
On the other hand: an enum can be too rigid, as it is not easily extendable. As Alain Picard has admitted, it would for vendors be more flexible to also allow formula’s (like rescaled measures have), for binary measures, e.g. “A * B” (instead of functor “times” to multiple A and B).
But that would require that a binary measure should have a formula next to a functor ?

The RTF discussed this issue, along with issues 17483 and 17503 and found a resolution which which is consistent with the resolution of both the other issues.
Per resolution of issue 17483, a BinaryMeasure, as DimensionalMeasure, has an optional formula.
Per resolution of issue 17503, a BinaryMeasure has an Operation (as customFunctor), if and only if its functor is custom. For this Operation the context is a measurand and a pair of base measurements.
Per Resolution of issue 17483, also a RescaledMeasure, as DimensionalMeasure, has an optional formula. Consistent with the resolutions for both CollectiveMeasure (per issue 17483) and BinaryMeasure (per issue 17503), the RTF then proposes to further revise RescaledMeasure, as follows:
• Add “offset” and “multiplier” to RescaledMeasure. For example, F = (C*9/5)+32. The addend (e.g. 32) is the offset and 9/5 is the multiplier.
• RescaledMeasure has an operation if and only if its multiplier and offset are not given. The context of it a measurand and a base measurement.

In industry, it is common to have composite measures with formulas like “A * (1 + B) / C”, whereby A, B and C are atomic measures. In this example, according to SMM, you would not have 4 measures, but 6, e.g.:
• 3 direct measures: A, B, C
• A rescaled measure, with formula “1+B”
• A binary measure, with functor “times”, to multiple A and the rescaled measure from above.
• A ratio measure to divide the previous one by C.
Though this is technically OK, it is not always handy, as “given” industry measures would have to be refactored into smaller ones.
I see a good reason why SMM measures are structured as they are: You have good grip than on the formula, the functor, etc. Because if you would allow for formula's like "( A * (1 + B) ) / C ", you would have difficulty in reconciling the various associated "sub" measurements with the formula of the measure that relates to the collective measurement. String parsing, etc.
SMM in its current form is very structured, but that would make interpretation and implementation also very straightforward. That is a big advantage and I like that.

But still I have trouble with e.g. industry-given libraries of VCG, SCOR, KPI LIbrary, etc., that though have composite measures with such more complicated formula's.

How to import such measures into an SMM based library?
Once imported, you could create more specific SMM measures, and refer to the original one as "equivalent" measure. But the main problem is that it cannot even be imported, as a collective measure in SMM does not allow for a formula, but only has a simple accumulator.

How can this be resolved ?

The RTF discussed this issue (at length) and found a resolution which addressed the core concern within the issue while preserving the general design pattern of SMM. It was agreed to improve the expressiveness of CollectiveMeasure by adding a formula to it, as well as the possibility for a custom accumulator (being an association to Operation). Hence the resolution includes the following:
• Add optional formula (string 0..1)) to DimensionalMeasure (every DimensionalMeasure can have one). Formulas are always descriptive and optional. Formula is a comment which briefly presents the Measure’s calculation in an algebraic manner. For example, “X + Y” or “Height * Width”. The decision to provide a formula would be entirely up to the SMM library designer. SMM designers can then write SMM libraries in a top down manner by turning DirectMeasures (or NamedMeasures) into CollectiveMeasures, BinaryMeasures and RescaledMeasures as needed. Also, a SMM design tool might fill in the descriptive formula when designer writes libraries bottom up. Unlike formula’s, operations are operational and defined with a coherent program fragment. The programming language must be stated and the fragment is expected to be well formed given the appropriate context.
• Add literal value “custom” to the Accumulator enumeration, and rename “operation” to “customAccumulator”. This property is defined as association to Operation. The custom accumulator of CollectiveMeasurement is only defined when its accumulator is “custom”.
In order for the meta-model to remain consistent and for the resolution to be generic, it was also agreed to further improve the expressiveness of some of the other Measures in similar ways, namely of BinaryMeasure per issue 17503 and of RescaledMeasure per issue 17484. So that the resolution of the three issues is consistent with each other.

In SMM, a binary measure has a functor.

Examples in the spec (instance models) suggest functor values like “sum”, “difference”, “times”, “divide”.

This sounds like functor should have an enumeration defined in the spec, like also accumulator has for a collective measure.

However, SMM does not do that for functor. Why not? It is rather similar (see also that accumulator has a value “sum” ..).

Introduce an Enumeration type for functor, with enumeration values “sum”, “difference”, “times” (or “product”) and “divide”, and also “custom”. In case the BinaryMeasure’s functor has value “custom”, also specify customFunctor, being an association to Operation (with association end name customFunctor).

The class CollectiveMeasurement has attribute "accumulator". This is wrong, as the CollectiveMeasure class has that attribute. CollectiveMeasurement should not have it therefore.

Remove accumulator from CollectiveMeasurement, as only CollectiveMeasure should have that property

In SMM spec there's the class RatioMeasurement.

However, in the beta2 spec, it is misspelled as RatioMeasurment..

This should be corrected.

Replace Class name “RatioMeasurment” with “RatioMeasurement” in the specification.

The class DimensionalMeasure should be abstract. Like also DimensionalMeasurement is abstract.
This is an inconsistency in the spec.

Both DimensionalMeasure and DimensionalMeasurement should be abstract

A standard component of measurement theory is 'Scales of Measurement' because they constrain the types of mathematical operations that can be performed on a measure. The base set of scales are 'Nominal', 'Ordinal', 'Interval', and 'Ratio'. The representation of a measure in SMM should contain information about the scale of measurement to indicate how it can be used and the limits of the operations that can be performed. If there is a way to enforce these constraints that would be best, but lacking that it would be useful for the specification of a measure to contain information about its limits for those who would incorporate the measure in their applications.

Add scaleOfMeasurement property to Measure, with enumerated type, consisting of the following five enumeration values: the four standard ones, namely “nominal”, “ordinal”, “interval”, and “ratio”, and the fifth being “custom”. In case of “custom”, the Measure has another string property instantiated, representing the custom scale (e.g. Guttman). In addition, add a few constraints, like: allow nominal & ordinal on GradeMeasure, and allow interval & ratio on DimensionalMeasure.

A ranking in SMM results in a mapping to symbolic value (a string), which is unit-less, and which does not allow to be used as factor in further measure-based computations.
It is required that similar interval-based mapping can also be used to result in a dimensional measurement, the value of which is numeric.

Proposed changes:
Rename SMM Ranking into GradeMeasure
Rename SMM Grade into GradeMeasurement
Rename RankingInterval into GradeInterval.
Add another measure, called RankingMeasure (specialization of DimensionalMeasure); It has associated RankingInterval (very much like the existing ones)
Ranking intervals of RankingMeasure have a numeric value instead of a symbolic string value.

Rename Ranking into GradeMeasure. Rename Grade into GradeMeasurement. Rename RankingInterval into GradeInterval. Add another Measure, called RankingMeasure (specialization of DimensionalMeasure). It has associated RankingInterval (very much like the existing one). Ranking intervals of RankingMeasure have a numeric value instead of a symbolic string value

"Section 10.5 (Operation Class) defines as normative languages "OCL" and "XQuery". This is too restrictive. An implementer should be able to implement Operations differently, without conflicting with the spec. Hence we suggest to add "Opaque" as a valid value as well".

In addition to the currently specified ones (OCL, Xquery), allow user-supplied values for language. Which could be “English”, “French”, “SBVR” or whatever language they want to informally express the body in.

Though, for MeasureRelationship in SMM, the "real" influence of one measure to other measure(s) is implied by the type of measure, its functors, operations, accumulators, etc., still it is, for business analyst understanding and maintenance sake very useful to add the influence type explicitly (the analyst may even define it before the actual functor or operation is specified). This will also be helpful in diagrammatic understanding in one glance of how measurements are influencing each other.

Resolution (as agreed with Larry Hines):

Add optional property "Influence" to MeasureRelationship. This is property with enumeration type "Influence", having 2 enum values: "positive", "negative".
In addition: a constraint, specifying that this property is not allowed for "EquivalentMeasureRelationship".

Add optional property "influence" to MeasureRelationship. This is a property with enumeration type "Influence", having two enumeration values: "positive", "negative".
In addition, a constraint is added, specifying that this property is not allowed for EquivalentMeasureRelationship (and neither for RefinementMeasureRelationship).

The association list of Observation class fails to include the arguments association to the Argument class.

Add the arguments association to the Associations table of the Observations Class

The semantics section of each collective measure class should discuss unit consistency. For example, the units of measure for the base measures must be equivalent to the unit of measure for the binary measure when the functor is addition.

Write some text about unit consistency for all aggregating Measures (CollectiveMeasure, BinaryMeasure, and RescaledMeasure). The text may be at the base relationship level instead of at the Measure level.

The constraints in Section 14.4 (BinaryMeasurement Class) should have BinaryMeasurement as the context, not RatioMeasurement.”

Replace “RatioMeasurement” with “BinaryMeasurement” as context in the constraint of BinaryMeasurement Class.

Make all examples shown in the normative clauses of the SMM doc compatible with the latest SMM spec

Make all examples (object diagrams) in the normative clauses of the SMM specification compatible with all balloted and accepted resolutions that impact the SMM meta-model.

Constraints on CollectiveMeasurement, BinaryMeasurement, RatioMeasurement and RescaledMeasurements are wrong. None have been updated to use their base measurement relationships.

Constraints updated to reference base measurement relationships

Add a re-scaling association to the all base measure relationship which support in-lining re-scaling to the other various collective measures

Associate BaseMeasureRelationship with RescaledMeasure, which enables to "transform" the base measurements upon aggregation to e.g. collective or binary measurement. This will make CollectiveMeasures, BinaryMeasures, etc. more powerful, so that users can achieve the same with less Measures.

Currently DimensionalMeasure has Unit of measure as an attribute with type string. Unit needs to be treated as a first class object and not just indicated by a name. A class need to be introduced for it and the attribute needs to be replaced with an association relating DimensionalMeasure to a Unit. Indication by name leaves open whether “meter”, “Meter” or “metre”. But the object for each would be the same and the case and internationalization would be left to rendering.

Replace the "unit" property (string) of DimensionalMeasure, by a "unit" association from DimensionalMeasure to UnitOfMeasure. This will greatly improve re-use and consistency of units, across DimensionalMeasures. Unit conversion can be left to rendering.

The constraints given in the subclasses of the Measurement class are wrong because there is no way to navigate from a Measurement to its measure without using the observedMeasure property of Measurement. That property needs to be documented. Then the constraints need to be fixed to use observedMeasure.

Document the observedMeasure property of the Measurement class. Fix the OCL constraints of the Measurement sub-classes to use observedMeasure

The description of the GradeInterval’s attributes maximumOpen and minimumOpen are backwards. It should say true iff the interval excludes the endpoint.

For attributes maximumOpen and minimumOpen, say true if the interval excludes the endpoint

We have no use cases demonstrating the value of these classes. They, moreover, are likely to introduce confusion about SMM. The classes and their associations should be removes.

Remove RecursiveMeasureRelationship and RecursiveMeasurementRelationship classes.

The containment association, ownedRelation, between SmmElement and SmmRelationship is inappropriate in that both are abstract classes and unnecessary in that it is defined already between the concrete extensions of SmmElement and SmmRelationship

Remove the containment association between SmmElement and SmmRelationship

Please add another issue to the SMM RTF: ObservedMeasure should not extend SmmRelationship

The “from” and “to” properties of SmmRelationship is not appropriate to ObservedMeasure. ObservedMeasure is a container (of measurements) for a measure and is not a relationship between a measurement and a measure.

ObservedMeasure to extend SmmElement

Minimum and maximum attributes for the Interval class should be optional

For nominal or for ordinal the base measure and interval mapping are not needed. To make that more convenient, I propose to make the following changes.

1. The minimum and maximum attributes for the Interval class will be optional

Attributes
maximumOpen:Boolean
True if and only if interval excludes maximum endpoint. Default = false.

minimumOpen:Boolean
True if and only if interval excludes minimum endpoint. Default = false.

maximum:Number[0..1]
Identifies interval’s maximum endpoint.

minimum:Number[0..1]
Identifies interval’s minimum endpoint.

2. We add constraints to Interval indicating that if either minimum or maximum is defined then both are defined.

Constraints
context Interval inv:

if maximum.isOclDefined

then minimum.isOclDefined and maximum = minimum and

(maximumOpen or minimumOpen ? maximum > minimum)

else not minimum.isOclDefined

3. We add constraints to RankingInterval requiring a maximum (and implicitly a minimum).

Constraints
context RankingInterval inv:

maximum.isOclDefined

4. We add constraints to GradeMeasure forbidding the intervals without minimum or maximums if gradeTo is specified.

Constraints
context GradeMeasure inv:

(gradeTo->notEmpty implies

interval->forall(i | not i.minimum.isOclUndefined() and

not i.maximum.isOclUndefined())) and

(interval->exists(i | i.minimum.isOclUndefined() or

i.maximum.isOclUndefined()) implies

gradeTo->isEmpty)

(1) The minimum and maximum attributes for the Interval class will be optional. (2) Add constraints to Interval indicating that if either minimum or maximum is defined then both are defined. (3) Add constraints to RankingInterval requiring a maximum (and implicitly a minimum). (4) Add constraints to GradeMeasure forbidding the intervals without minimum or maximum if gradeTo is specified.

Please add another issue to the SMM RTF: Provide non-software non-normative measure examples

SMM should provide a few non-normative example measures especially non-software examples. The SEI maintainability measure could be up-dated as a software example and a few non-software examples added.

Add a new clause for non-normative examples which should include SEI maintainability and some business examples.

Please add another issue to the SMM RTF: Remove non-normative Library of Measures clause

The non-normative Library of Measures clause is out-of-date with respect to SMM. It is too focused upon examples of software measures which is confusing now that SMM is applicable outside of software measurement. Also the clause contains no MeasureLibrary, CategoryRelationship or MeasureCategory elements and, thus, is not a demonstration of a library of measures.

The non-normative Library of Measures clause should be removed.

Remove both non-normative Library of Measures clause and the non-normative Library of Categories clause.
This resolution also covers what is requested for issue 19451, namely to make non-normative Measure examples that remain, compliant with the revised meta-model

Please add a new issue of the SMM RTF: Old measure(ment) names still persist in the document

The naming scheme for some measure and measurement classes is not consistent.

For most measures and their corresponding measurement classes if the measure class is “X”Measure then the measurement class is “X”Measurement. This scheme is followed for all but the Counting measure class and its corresponding Count measurement class. Each should be renamed to CountingMeasure and CountingMeasurement respectively.

Also, in places the “X”Measure or “X”Measurement is shortened to just “X”. For example in the specification sometimes Ratio is used, and sometimes RatioMeasure. Even the class's section is called "Ratio Class" .. It should be RatioMeasure consistently.

Regarding Grade: It is, consistently and correctly, GradeMeasure in the model, and often in the document. But not always. There are occurrences in the document where you use Grade, and where it better should be GradeMeasure (or GradeMeasurement, if it is about the measurement side). Sometimes there is just qualitative speak where you can leave it like "grade", but sometimes it is meant as more formal, where it still reads as "grade", e.g. somewhere you talk "grade subclass" (should be GradeMeasure), and sometimes "Grade measure", which should be GradeMeasure, etc. Maybe you find all "grade" occurrences and fix some of them. The same problem might exist wrt Ranking.

Replace "Ratio" as name of the ratio measure class with "RatioMeasure".
Similarly, replace “Counting” with “CountingMeasure” and “Count” with “CountingMeasurement”.
The naming consistency problem regarding “Grade” has been fixed by the resolution of issue 17535.

Please add another issue to the SMM RTF: The Percentage measure(ment) has been replaced by the RatioMeasure(ment)

The old name, Percentage, still appears in 2 places in the document.

The first reference is in the Measurement Class clause. It should be removed entirely. Percentage has been replaced by RatioMeasurement which is a subclass of DimensionalMeasurement. Hence, the phrase “The DimensionalMeasurement and Percentage subclasses” simplifies to “The DimensionalMeasurement subclass”.

The second reference is in Software Engineering Institute (SEI) Maintainability Index clause. The PercentageMeasure should be replaced with RatioMeasure.

Simplify the phrase “The DimensionalMeasurement and Percentage subclasses” in the text of the sub-clause of Measurement Class to “The DimensionalMeasurement subclass”.
Note: The part about the second reference is actually resolved by issue 19609, which removed the problematic text.

Please add another issue to the SMM RTF: An Operation should be reusable as the operation of multiple measures

DirectMeasure may have an operation association with an Operation. That operation could be re-used by other measures as their operation which means to multiplicity should not be 1 for the unnamed role, but should be 0 to many.

BinaryMeasure, similarly, may have a customFunctor association with an Operation as may a CollectiveMeasure have a customAccumulator association with an Operation. The operations could be re-used by other measures which means to multiplicity should not be 1 for the unnamed role, but should be 0 to many.

Change multiplicity to 0..* for associated Operation as shown in Figures 5,6 and 7.

Stereotypes, like classes, define sets of objects which can be measured and should be allowed as a way to define the scope of a measure.

Add optional stereotype attribute to Scope class. Make its class attribute optional. Add a constraint to allow the scope to be specified by either the class or the stereotype attribute. Add text in the semantics class about stereotype specifying the scope of a measure.

Association from MeasureCategory to MeasureCategory did not have a name. The ends did have names. Named it HasSubCategory. The name is not visible in any diagram and does not appear in the doc.

The HasCategories association from MeasureLibrary to CategoryRelationship had one unnamed end. Named it libraries. The end is owned by the association. The name is not visible in any diagram and does not appear in the doc.
The following association end is private, whereas it must be public: in the RescaledMeasure – Operation association, the end of RescaledMeasure (rescalesFor)".

Name association from MeasureLibrary to MeasureLibrary as “HasSubCategory”. Name the unnamed end of the HasCategories association from MeasureLibrary to CategoryRelationship as “libraries”. Change visibility of the rescalesFor end of the association between RescaledMeasure and Operation from private to public. These changes impact the XMI only.

SMM 1.0 had both Date (sub-clause 8.8) and Timestamp (sub-clause 8.9) defined. Timestamp was nowhere used as type. Hence, in a previous ballot, we asked to vote for removing Timestamp (per issue 19604, “Remove the TimeStamp primitive type”). Meanwhile we encountered that Date was only used inconsistently. The meta-model diagrams showed Date as type of Observation.whenObserved, but the attributes table in sub-clause 16.2 just specified "date" (small) as type for that attribute. This is obviously wrong and has to be fixed. But this triggered new discussion, that resulted to the conclusion that Observation.whenObserved should not be typed by Date at all, but rather by TimeStamp, because SMM should enable taking snapshots or samples multiple times a day, and not just once a day. (Another reason why this error is only detected so late is the fact that in the SMM implementation of one of the implementers Date was mapped to java.util.Date which is actually a datetime type ...)

Â

Resolution: Change type of Observation.whenObserved from Date to TimeStamp. Update the attributes table in sub-clause 16.2, as well as all diagrams on which the attribute is exposed, accordingly. Remove Date (sub-clause 8.8), as it will no longer be used then. This issue will then also supersede issue 19604 (“Remove the TimeStamp primitive type”). It will also partly supersede the older issue 15479 (“it should be made clear that Date and Timestamp are PrimitiveTypes”). This issue will still impact the Timestamp class, but no longer the Date class, as it will now be removed.Â

Change type of Observation.whenObserved from Date to TimeStamp. Update the attributes table in Sub-clause 16.2, as well as all diagrams on which the attribute is exposed, accordingly. Remove Date (sub-clause 8.8), as it will no longer be used then. This issue will then also supersede issue 19604 (Remove the TimeStamp primitive type). It will also partly supersede the older issue 15479 (it should be made clear that Date and Timestamp are PrimitiveTypes). This issue will still impact the Timestamp class, but no longer the Date class, as it will now be removed.
Also make the mapping of TimeStamp to dateTime in XSD explicit in the XMI.

Summary: Multiplicity of RescaledMeasurement.rescaleFrom is [0..*]. This is wrong. Because this would imply that it could rescale multiple DimensionalMeasurements simultaneously. It should be [0..1] therefore. This issue supersedes issue 17504. The reason is that issue 17504 suggested that the multiplicity of RescaledMeasure.rescaleFrom being [0..*] was also wrong and that it proposed to change it to [1] as well. That was wrong. Because the RescaledMeasure itself should be kept re-usable. But any application of it, i.e., a related RescaledMeasurement, should not rescale more than one DimensionalMeasurement.

Resolution: Change multiplicity of RescaledMeasurement.rescaleFrom from [0..*] to [0..1]. Note that this cannot be higher than 1 (for reasons explained in Summary). On the other hand, it should allow "0", to stay consistent with the semantics of the RescaledMeasurement.isBaseSupplied. Multiplicity of RescaledMeasure.rescaleFrom will also change, but from [0..*] to [1..*]. The “*” in this is to keep the possibility of reuse of a RescaledMeasure, and the “1” in this is to make it more consistent with other aggregating Measures, which all aggregate from [1] DimensionalMeasure (instead of [0..1]). This resolution supersedes the resolution of 17504.Â

Change multiplicity of RescaledMeasurement.rescaleFrom from [0..*] to [0..1]. Note that this cannot be higher than 1 (for reasons explained in Summary). On the other hand, it should allow "0", to stay consistent with the semantics of RescaledMeasurement.isBaseSupplied. Multiplicity of RescaledMeasure.rescaleFrom will also change, but from [0..*] to [1..*]. The “*” in this is to keep the possibility of reuse of a RescaledMeasure, and the “1” in this is to make it consistent with other aggregating Measures, which all aggregate from [1] DimensionalMeasure (instead of [0..1]).

Summary: The SMM spec, in the Associations table of the sub-clause that defines the RescaledMeasure class, two associations are defined: “baseMeasure” and “rescaleFrom”. The meta-model only declares one of them, namely “rescaleFrom”. The other one, “baseMeasure”, is an oversight, and is redundant. It should be removed from the table. This issue supersedes issue 17478. The reason of this new issue, superseding issue 17478 is, that the resolution of 17478 also proposed a fix of the multiplicity of the association end of the other association (rescaleFrom), from [0..*] to [1], which was wrong.)

Resolution: Remove the "baseMeasure" association from the Associations table of the RescaledMeasure class. This resolution supersedes the resolution of issue 17478.

Remove the "baseMeasure" association from the Associations table of the RescaledMeasure class.

The types of BinaryMeasure.baseMeasure1, BinaryMeasure.baseMeasure2 and BinaryMeasurement.baseMeasurement1To are wrong. The type should be a Measure(ment)Relationship class. Also, the descriptions of BinaryMeasure baseMeasure1, BinaryMeasure.baseMeasure2, BinaryMeasurement.baseMeasurement2 and CollectiveMeasurement.baseMeasurement are unclear

In Attributes table of BinaryMeasure class: Change the type of BinaryMeasure.baseMeasure1 to Base1MeasureRelationship, and its description to “Specifies the relationship instance that defines the first measure accumulated by this binary measure”. And change the type of BinaryMeasure.baseMeasure2 to Base2MeasureRelationship, and its description to “Specifies the relationship instance that defines the second measure accumulated by this binary”.
In Attributes table of BinaryMeasurement class: Change the type of BinaryMeasurement.baseMeasurement1 to Base1MeasurementRelationship, and its description to “Specifies the relationship instance that defines the first base measurement accumulated for this measurement”. And change the type of BinaryMeasurement.baseMeasurement2 to Base2MeasurementRelationship, and its description to “Specifies the relationship instance that defines the second base measurement accumulated for this measurement”.
In Attributes table of CollectiveMeasurement class: Change the type of CollectiveMeasurement.baseMeasurement to BaseNMeasurementRelationship, and its description to “Specifies the relationship instance that defines the accumulation for this measurement”.

It is currently the case that Observation.requestedMeasures is of type SmmElement. Constraints have been added to make sure that one does not pass a e.g. SmmModel instance as a requestedMeasure but only instances of type Measure, MeasureCategory and CategoryRelationship.

My suggestion is to change the type from SmmElement to AbstractMeasureElement. We would then be able to measure the following:
MeasureCategory - e.g. Measures that fall in the same category
Scope - e.g. Measures that use the define the same scope
Characteristic - e.g. Measures that are characterized by a certain characteristic
Operation - e.g. Measures that use a certain operation
OCLOperation - e.g. Measures that use a certain OCLOperation
Measure

This would make the metamodel cleaner by having lessing constraints and making it easier to understand. Could it be that this was caused because of the fact that there is no section about AbstractMeasureElement?

Change the type of requestedMeasures to be AbstractMeasureElement

There are three problems here: 1) Several derived unions (for from, to, inbound and outbound) are not defined correctly, e.g. at specialized level the properties where they are assumed to be derived from are not defined as their subsets. 2) They are defined as derived unions in the model, but not in the association tables in the specification, and 3) in the Association tables of Measure Class (10.5) and Measurement Class (13.1), the description of inbound and outbound both talk about the “to-endpoint”. But one of these two should be “from-endpoint”. This issue supersedes issue 15477 (because it was originally balloted with a resolution that was incorrect, as the actual problem was overlooked).Â

The properties that were so-far named “outbound” and “inbound”, of SmmElement and its specializations, should be derived unions (isDerivedUnion = true), but this requires that, the properties of specialized classes, from which they are derived, should be defined as subsets (subsettedProperty being set to the property that is the union). The “derived union” will make it unambiguous how the derivation is done, and in combination with “subsets” we apply it according to the UML rules. There is one problem in this: UML 2.4.1 (and still the same in UML 2.5) does not allow subsetting of property of same name. Hence we rename SmmRelationship.inbound and SmmRelationship.outbound to SmmRelationship.inRelationships and SmmRelationship.outRelationships respectively.
Furthermore, to avoid that, at specialized level, classes Measure, Measurement, etc. have inherited property “inRelationship” next to “inbound” and “outRelationship” next to “outbound”, we define “inbound” as “redefines inRelationships” and “outbound” as “redefines outRelationships”.
The properties “to” and “from” of SmmRelationship and its specializations are no longer derived. What is instead needed is that, at specialized levels, “to” “redefines” “to” of a parent level, and “from” “redefines” “from” of a parent level. This way we enforce that for any SmmRelationship there’s always exactly one “to” and one “from”. The changes implied here will impact both the model (and its diagrams) and the association tables in the corresponding sub-clauses of the specification.
Furthermore, in the Association tables of Measure Class (10.5) and Measurement Class (13.1), the description of inbound and outbound both talk about the “to-endpoint”. But for outbound it should be the “from-endpoint”.

“Getters” for properties in the meta-model are redundant and unnecessary. For example SmmRelationship::getFrom(). These operations should be removed. This issue supersedes 15476 (because that issue was balloted originally as “duplicate / merged”, suggesting that the removal of such “getters” was already done as part of migration to CMOF. But that does not make sense.)

Remove Operations tables from Sub-clauses 8.2 and 8.4.

This is a small improvement upon the initial implementation of label format support.

Discussion:
The labelFormat attribute was added to the Measure class in issue #14101. Since then it has been noticed that there are actually 2 main use cases for labels. The first one is to provide a label that describes the measure and the other one is to provide a label describing the measurement. This issue addresses this shortcoming.

Secondly, we are also here expanding the use of the Operation class by changing the specification of the label format in order to have queries simply defined in terms of Operations instead of declaring the query and its language within the label format.

Summary of change:
· Add new attribute and change name of existing one.
o Rename attribute labelFormat:String in Measure class to measureLabelFormat:String
o Add attribute measurementLabelFormat:String in Measure class.
· Add new operations and change name of existing ones.
o Rename operation getLabel():String in Measurement class to getMeasureLabel():String
o Add operation getMeasurementLabel():String in Measurement class.
· Change specification of labelFormat to support use of Operation
o Change wording of standard syntax to the following:
§ The standard syntax, which is always valid, starts by specifying a context object, followed by a literal colon ":", then an operation whose name must be the name of a valid instance in the Operation class.

• Add new attribute and change name of existing one.
o Rename attribute labelFormat:String in Measure class to measureLabelFormat:String
o Add attribute measurementLabelFormat:String in Measure class.
• Add new operations and change name of existing ones.
o Rename operation getLabel():String in Measurement class to getMeasureLabel():String
o Add operation getMeasurementLabel():String in Measurement class.
• Change specification of labelFormat to support use of Operation
o Change wording of standard syntax to the following:
? The standard syntax, which is always valid, starts by specifying a context object, followed by a literal colon “:”, then an operation whose name must be the name of a valid instance in the Operation class.

Scales of Measurement are a fundamental property of a measure describing the allowable mathematical transformations that can be legitimately applied to it.

Discussion:
Attached are some URLs that will give you an overview of Scales of Measurement. They are a fundamental property of a measure describing the allowable mathematical transformations that can be legitimately applied to it. Since they therefore determine the statistical methods that can be applied to the measure, they need to be treated as a first level attribute of a measure.
http://www.math.sfu.ca/~cschwarz/Stat-301/Handouts/node5.html
http://en.wikipedia.org/wiki/Scale_of_measurement (not always written in easily understood terms)
http://www.wadsworth.com/psychology_d/templates/student_resources/workshops/stat_workshp/scale/scale_01.html (tutorial - behavioral science view)

Summary of change:
· Add enumeration MeasurementScale
o Add enu ordinal, nominal, interval and ratio.
· Add attribute scale:MeasurementScale to Measure class
o This defines the scale of Measurement for measurements produced by the measure.

• Add named relation operation [0..1] from CollectiveMeasure to Operation
• Add constraint specify that either an Accumulator or an Operation, but not both should be specified for instances of CollectiveMeasure.
• Add documentation to clearly identify the defined uses of the NamedMeasure class.

When the MeasureLibrary was introduced, this attribute was inadvertently left behind.

Discussion:

Summary of change:
· Drop library attribute from Measure class

• Drop library attribute from Measure class

The Measure class lacked a way to provide a default value when some children measure has no measurands. The defaultQuery plays that role.

Discussion:
The defaultQuery is simply a small improvement to handle the specific case where a non-direct measure (i.e. a measure that depends on another for its value) happens not to have any available value from what should have been its "base measure". This allows us to specify a default query or value to be returned instead of either null or of failing the measurement. This is a normal situation that can happen when certain optional "children" don't exist.

Summary of change:
· Add named relation default [0..1] form Measure to Operation

• Add named relation defaultQuery [0..1] from Measure to Operation

Need to add Standard Deviation to the Accumulator enumeration.

Discussion:
Also need to add missing section documenting Accumulator in the specification. Was missing in document.

Summary of change:
· Add documentation for existing Accumulator enumeration
· Add enum value of standardDeviation to Accumulator enumeration

• Add documentation for existing Accumulator enumeration
• Add enum value of standardDeviation to Accumulator enumeration

SMM initially stood for Software Metrics Meta-Model, but from its inception, the meta-model was always made to support measuring any MOF based elements. As it became clear in the community that this specification was really applicable to more than software, the meaning of its name started to become an issue and a distraction. As such it has been recommended to change the meaning of the name to Structured Metrics Meta-Model in order to reflect that the metrics apply equally well to any structured model elements. Summary of change:
· Change title on cover page
· Change name on Co-submitting companies and supporters
· Change name on all document footer
· Changes in Scope section
· Changes in Conformance section
· Changes in SMM section
· And other places as shown in the change bar document

• Change title on cover page
• Change name on Co-submitting companies and supporters
• Change name on all document footer
• Changes in Scope section
• Changes in Conformance section
• Changes in SMM section
• And other places as shown in the change bar document

A number of changes were made in the scope class in order to better support library of measures, reduce coupling, support dynamic measures and help clarify and document the format of the class attribute.

Discussion:

Summary of change:
· Remove "enumerated" attribute
· Remove "element" association
· Document and define content of "class" attribute
· Add new "breakValue" attribute and define its allowable content
· Add new "recursive" attribute
· Add a new equivalent "breakValue" attribute to the measurement class

• Remove “enumerated” attribute
• Remove “element” association
• Document and define content of “class” attribute
• Add new “breakCondition” attribute and define its allowable content (updated in 14602)

• Add a new equivalent “breakValue” attribute to the measurement class

A number of small corrections were made to some of the graphs, outside of any changes to the specification.

Discussion:

Summary of change:
· Show missing parent Characteristic association in Characteristic
· Show missing attributes to the SmmElement class
· Measurement graph didn't show measurand association

• Show missing parent Characteristic association in Characteristic
• Show missing attributes to the SmmElement class
• Measurement graph didn’t show measurand association

There are a number of inconsistencies in the SMM specification in regards to naming of classes and elements. This results in various classes being renamed in order to provide a more uniform naming convention, as was also done during the KDM FTF.

Discussion:

Summary of change:
· Change SMM_Model to SmmModel everywhere
· Change SMM_Element to SmmElement everywhere
· Change SMM_Relationship to SmmRelationship everywhere
· Change Category_Relationship to CategoryRelationship everywhere
· Change SMM_Category to Category (only use SMM for core elements of Model, Element and Relationship)
· Change short_description to shortDescription

• Change SMM_Model to SmmModel everywhere
• Change SMM_Element to SmmElement everywhere
• Change SMM_Relationship to SmmRelationship everywhere
• Change Category_Relationship to CategoryRelationship everywhere
• Change SMM_Category to Category (only use SMM for core elements of Model, Element and Relationship)
• Change short_description to shortDescription

The associations for the Category class were not captured correctly and there was also a name duplication.

Discussion:

Summary of change:
· Add documentation of category association in Category
· Improve documentation and cardinality of categoryElement association in Category
· Rename 2nd categoryElement association to categoryMeasure in Category
· Remove parameter association in Category

• Add documentation of category association in Category
• Improve documentation and cardinality of categoryElement association in Category
• Rename 2nd categoryElement association to categoryMeasure in Category
• Remove parameter association in Category

Summary:
The associations for the SmmRelationship class should be marked as derived union and should also have opposites of inbound and outbound as derived unions as well.

Discussion:

Summary of change:
· Add inbound and outbound association in SmmElement
· Change to and from association in SmmRelationship to indicate derive union

• Add inbound and outbound association in SmmElement
• Change to and from association in SmmRelationship to indicate derive union

This issue will help clarify operations that use to be defined only as string and it also introduces a powerful mechanism to support code reuse when dealing with OCL, thus strengthening OCL support in the model.

Discussion:
In the original design of the SMM spec, operations were just defined as string, not even mentioning the nature of those strings. An earlier issue (#14103) provide for the initial introduction of the Operation class for use by DirectMeasure. The use of the Operation class is being extended to other operations, such as mapping, breakCondition and recognizer.
The second part is the introduction of the OCLOperation class. This class allows for the definition and registration of OCL helper methods in the context of specific classifiers. These operations allow for the definition and reuse of often lengthy and complex OCL methods. It is the implementer's responsibility to determine how to best provide for the parsing or execution environment of those methods. Any helper method that is defined with an OCLOperation then becomes available for OCL based operations applied to the proper classifier.

Summary of change:
· Change generalization of Operation to AbstractMeasureElement
o Operation was not correctly sub-classed and that lead to issues of containment
· Add OCLOperation class, a generalization of AbstractMeasureElement
o Add attribute context:String
§ Context defines to OCL the classifier for which this operation is defined.
o Add attribute body:String
§ The OLC helper function code
· Change type of mapping in EquivalentMeasureRelationship to Operation
o Drop attribute mapping in class EquivalentMeasureRelationship
o Add named relation mapping [0..1] form EquivalentMeasureRelationship to Operation
· Change breakCondition type to Operation
o Drop attribute breakCondition in class Scope
o Add named relation breakCondition [0..1] form Scope to Operation
· Change recognizer type to Operation
o Drop attribute recognizer in class Scope
o Add named relation recognizer [0..1] form Scope to Operation

• Change generalization of Operation to AbstractMeasureElement
o Operation was not correctly sub-classed and that lead to issues of containment
• Add OCLOperation class, a generalization of AbstractMeasureElement
o Add attribute context:String
? Context defines to OCL the classifier for which this operation is defined.
o Add attribute body:String
? The OLC helper function code
• Change type of mapping in EquivalentMeasureRelationship to Operation
o Drop attribute mapping in class EquivalentMeasureRelationship
o Add named relation mapping [0..1] from EquivalentMeasureRelationship to Operation
• Change breakCondition type to Operation
o Drop attribute breakCondition in class Scope
o Add named relation breakCondition [0..1] from Scope to Operation
• Change recognizer type to Operation
o Drop attribute recognizer in class Scope
o Add named relation recognizer [0..1] from Scope to Operation

Summary:
The Measure class, through its related scope class, provides support for specifying the class of the measure, but it limited the scope of refinements to be based on containment relations. This new measurandQuery operation removes this limitation.

Discussion:
In the original design of the SMM spec, the definition of the refinement relation was not clearly defined or elaborated. This under specification would either lead to non-executable models that could use any refinement relation that they wish, or for executable models being forced to only support and understand containment refinement relations.
The purpose of the measurandQuery is to allow models to be able to correctly specify the exact refinement relation, when this relation is not the default containment relation. It thus provide for an alternative way of adequately specifying the relation used to retrieve the appropriate measurands.

Summary of change:
· Add named relation measurandQuery[0..1] form MeasureRelationship to Operation

• Add named relation measurandQuery[0..1] from MeasureRelationship to Operation

Summary:
Provide a mechanism by which measure can define and process replaceable arguments.

Discussion:
In the original design of the SMM spec, there is no provision to account for the fact that measures often need some parameter to operate. We often don't want the measure to apply to every possible measurand of a certain class. The original specification addressed this with the recognizer, but it failed to provide any means to supply variable information to those recognizers.
This new support for parameterized measures, allows an operation to define a placeholder for an incoming argument and replace it at runtime with a specific value, like when dealing with date ranges for example.
The implementer is responsible, when using the measure library in an executable fashion, to determine base on the requested measures of his observation, what are all of the arguments that should be passed in with the observation in order to properly perform the measurements.

Summary of change:
· Add DefaultQuery to Measure (constraint not DirectMeasure)
o Add attribute type:String
§ This represents the type of the argument as it was defined in the operation. This value is only expected to come from the getXXXArguments() methods on the Measure class.
o Add attribute value:String
§ This represent the value of the argument either as the default or as supplied with the observation
o Add containment relation from Observation to Argument
· Add operation getParamStrings():String[0..*] to Operation class
o This operation returns the set of String that defines the parameter in use by an operation.
o The format of a parameter within an operation is as follow:
§ '

'
· where typeName represents the type of the parameter and is optional
· where parameterName represents the name of the parameter (required)
· where defaultValue represents a default value to offer (on getArguments()) or to use if not supplied as Argument to an observation. defaultValue is optional.
· Add operation getArguments():Argument[0..*] to Measure class
o This operation returns the set of arguments that the different operations of the measure have defined and got returned by getParamStrings().
· Add operation getAllArguments():Argument[0..*] to Measure class
o This operations returns the set of arguments for this measure and any child measure required for the execution of the measure. It should call getArguments() on itself and everyone of its child measures.

• Add Argument class, a generalization of SmmElement
o Add attribute type:String
? This represents the type of the argument as it was defined in the operation. This value is only expected to come from the getXXXArguments() methods on the Measure class.
o Add attribute value:String
? This represent the value of the argument either as the default or as supplied with the observation
o Add containment relation from Observation to Argument
• Add operation getParamStrings():String[0..*] to Operation class
o This operation returns the set of String that defines the parameter in use by an operation.
o The format of a parameter within an operation is as follow:
? '

'
• where typeName represents the type of the parameter and is optional
• where parameterName represents the name of the parameter (required)
• where defaultValue represents a default value to offer (on getArguments()) or to use if not supplied as Argument to an observation. defaultValue is optional.
• Add operation getArguments():Argument[0..*] to Measure class
o This operation returns the set of arguments that the different operations of the measure have defined and got returned by getParamStrings().
• Add operation getAllArguments():Argument[0..*] to Measure class
o This operations returns the set of arguments for this measure and any child measure required for the execution of the measure. It should call getArguments() on itself and everyone of its child measures.

This issue deals with the conversion of all the various relations around Measure and Measurement into relationship classes extended from SmmRelationship. It continues the standardization and renaming process, while making the model more versatile.

• Add all classes for measure and measurement relationships
o Add RecursiveMeasureRelationship class, a generalization of MeasureRelationship
? Drop recursive attribute from Scope class
o Add RefinementMeasureRelationship class, a generalization of MeasureRelationship
? Drop refinement relation from Measure class
o Add RescaledMeasureRelationship class, a generalization of MeasureRelationship
? Drop BaseMeasure relation from RescaledMeasure class
o Add RankingMeasureRelationship class, a generalization of MeasureRelationship
? Drop BaseMeasure relation from Ranking class
o Add BaseMeasureRelationship class, a generalization of MeasureRelationship
? Drop BaseMeasure relation from CollectiveMeasure
o Add Base1MeasureRelationship class, a generalization of MeasureRelationship
? Drop baseMeasure1 relation from BinaryMeasure
o Add Base2MeasureRelationship class, a generalization of MeasureRelationship
? Drop baseMeasure2 relation from BinaryMeasure
o Add RecursiveMeasurementRelationship class, a generalization of MeasurementRelationship to provide equivalent relation in measurement that exists in measure.
o Add RefinementMeasurementRelationship class, a generalization of MeasurementRelationship to provide equivalent relation in measurement that exists in measure.
o Add RankingMeasurementRelationship class, a generalization of MeasurementRelationship
? Drop BaseMeasurement relation from Grade class
o Add RescaledMeasurementRelationship class, a generalization of MeasurementRelationship
? Drop BaseMeasurement relation from ReScaledMeasurement class (being renamed in other issue to RescaledMeasurement)
o Add BaseMeasurementRelationship class, a generalization of MeasurementRelationship
? Drop BaseMeasurement relation from CollectiveMeasurement class
o Add Base1MeasurementRelationship class, a generalization of MeasurementRelationship
? Drop BaseMeasurement1 relation from BinaryMeasurement class
o Add Base2MeasurementRelationship class, a generalization of MeasurementRelationship
? Drop BaseMeasurement2 relation from BinaryMeasurement class
• Rename consistently all XXX (Measure | Measurement) (Relationship)* classes
o Rename class ReScaledMeasurement to RescaledMeasurement to be consistent with related measure class called RescaledMeasure
o Rename EquivalentRelationship to EquivalentMeasureRelationship
• Add missing operations to aggregate union result sets for relations on SmmElement, Measure and Measurement
o Add operation getFrom():SmmElement[1] in class SmmRelationship
o Add operation getTo():SmmElement[1] in class SmmRelationship
o Add operation getInbound():SmmRelationship[0..*] in class SmmElement
o Add operation getOutbound():SmmRelationship[0..*] in class SmmElement

Source: Alain Picard, Benchmark Consulting
Summary:
As we started to produce ever larger models, it quickly became apparent that a flat model like the SMM is not very appropriate. So we redesigned the model, to better divide it along the line of Measure library and Observation. Then we reclassified all relations to create containment relationships that are much more aligned with the natural structure of the model.

Discussion:

Summary of change:
· Add New MeasureLibrary class, a generalization of SmmElement
· Add new AbstractMeasureElement class, a generalization of SmmElement
o Change Characteristic to now be generalize from AbstractMeasureElement
o Change Measure to now be generalize from AbstractMeasureElement
o Change MeasureCategory to now be generalize from AbstractMeasureElement
o Change Scope to now be generalize from AbstractMeasureElement
· Change model composition:
o Remove SmmModel containment of SmmElement
o Add SmmModel containment of MeasureLibrary, with a named relation of libraries [0..*]
o Add SmmModel containment of Observation, with a named relation of observations [0..*]
o Add Observation containment of ObservationScope, with a named relation of scopes [0..*]
o Add Observation containment of ObservedMeasure, with a named relation of observedMeasures [0..*]
o Add ObservedMeasure containment of Measurement, with a named relation of measurements [0..*]
o Add MeasureLibrary containment of AbstractMeasureElement, with a named relation of measureElements [0..*]
o Add MeasureLibrary containment of CategoryRelationship, with a named relation of categoryRelationships [0..*]
o Add Measure containment of MeasureRelationship, with a named relation of measureRelationships[0..*]

• Add New MeasureLibrary class, a generalization of SmmElement
• Add new AbstractMeasureElement class, a generalization of SmmElement
o Change Characteristic to now be generalize from AbstractMeasureElement
o Change Measure to now be generalize from AbstractMeasureElement
o Change MeasureCategory to now be generalize from AbstractMeasureElement
o Change Scope to now be generalize from AbstractMeasureElement
• Change model composition:
o Remove SmmModel containment of SmmElement
o Add SmmModel containment of MeasureLibrary, with a named relation of libraries [0..*]
o Add SmmModel containment of Observation, with a named relation of observations [0..*]
o Add Observation containment of ObservationScope, with a named relation of scopes [0..*]
o Add Observation containment of ObservedMeasure, with a named relation of observedMeasures [0..*]
o Add ObservedMeasure containment of Measurement, with a named relation of measurements [0..*]
o Add MeasureLibrary containment of AbstractMeasureElement, with a named relation of measureElements [0..*]
o Add MeasureLibrary containment of CategoryRelationship, with a named relation of categoryRelationships [0..*]
o Add Measure containment of MeasureRelationship, with a named relation of measureRelationships[0..*]

Source: Alain Picard, Benchmark Consulting
Summary:
The CollectiveMeasure class was modified to allow more flexibility in a more compact model. This is a follow up to the previous issue to remove unneeded artifacts

Discussion:

Summary of change:
· Deleted AggregateMeasure and AggregatedMeasurement classes.

• Deleted AggregateMeasure and AggregatedMeasurement classes.

Source: Alain Picard, Benchmark Consulting
Summary:
This is a follow-up to continue improving upon the Observation class. In order to allow observation to be the starting point of a request to perform measurement and be the collector of those measurements. The changes here address these short-comings.

Discussion:

Summary of change:
· Added a new "ObservedMeasure" class, a generalization of SmmRelationship, with the following associations:
o Add named relation of measure[1] from ObservedMeasure to Measure
o Owning the measurements having been calculated for a specific measure
· Added a new association to the Observation class
o observedMeasures, owning the ObservedMeasure instances for an observation
· Remove relation from Measurement to Measure as it is now being replaced.
· Add named relation of requestedMeasures[0..*] from Observation to SmmElement (with constraints)

• Added a new “ObservedMeasure” class, a generalization of SmmRelationship, with the following associations:
o Add named relation of measure[1] from ObservedMeasure to Measure
o Owning the measurements having been calculated for a specific measure
• Added a new association to the Observation class
o observedMeasures, owning the ObservedMeasure instances for an observation
• Remove relation from Measurement to Measure as it is now being replaced.
• Add named relation of requestedMeasures[0..*] from Observation to SmmElement (with constraints)

The DirectMeasure class was modified to allow more flexibility in expressing operations. With the new Operation class, operations can be defined in terms of either OCL or XQuery and they can also be re-used.

Discussion:

Summary of change:
· Added a new "Operation" class that defines the following:
o language
o body
· Replace the DirectMeasure class "operation" attribute with an association of the same name pointing to the "Operation" class.

• Added a new “Operation” class that defines the following:
o language
o body
• Replace the DirectMeasure class “operation” attribute with an association of the same name pointing to the “Operation” class.

The CollectiveMeasure class was modified to allow more flexibility in a more compact model.

Discussion:

Summary of change:
· Added a new enumeration called Accumulator that defines the following:
o Sum
o Maximum
o Minimum
o Average
· Changed the CollectiveMeasure class "accumulator" attribute from a string to an "Accumulator" value.
· Deleted AdditiveMeasure and MaximalMeasure classes.

• Added a new enumeration called Accumulator that defines the following:
o Sum
o Maximum
o Minimum
o Average
• Changed the CollectiveMeasure class “accumulator” attribute from a string to an “Accumulator” value.
• Deleted AdditiveMeasure and MaximalMeasure classes.

A number of changes were made in the Measure class in order to better support library of measures and to align with the creation of a new distinct EquivalentRelationship class to replace the previous association.

Discussion:

Summary of change:
· Add new "labelFormat" attribute and define its allowable content
· Add new "visible" attribute
· Added a new EquivalentRelationship class with a "mapping" attribute.
o Note that the content of the mapping attribute is still not well defined. We are currently using it in a very proprietary way and are looking to better explain and elaborate on this later.
· Re-scope the definition of equivalent measure
· Establish the concept of using equivalent measure to derive an otherwise irresolvable measure.
· Modified the endpoints of the equivalentTo and equivalentFrom associations
· Clarify the "from" and "to" association in the MeasureRelationship class

• Add new “labelFormat” attribute and define its allowable content
• Add new “visible” attribute
• Added a new EquivalentRelationship class with a “mapping” attribute. (updated in 14602)
o Note that the content of the mapping attribute is still not well defined. We are currently using it in a very proprietary way and are looking to better explain and elaborate on this later.
• Re-scope the definition of equivalent measure
• Establish the concept of using equivalent measure to derive an otherwise irresolvable measure.
• Modified the endpoints of the equivalentTo and equivalentFrom associations
• Clarify the “from” and “to” association in the MeasureRelationship class

This is the latest in a series of renaming to help better clarify the scope of the categories that we are referring to. Discussion:

Summary of change:
· Change Category to MeasureCategory everywhere

• Change Category to MeasureCategory everywhere

The SMM should support some basic extensibility. This extensibility model should be aligned with the KDM, and as with the KDM the content of those extension is beyond the scope of this specification and tools that don't understand these extensions should just pass this information untouched.

Discussion:

Summary of change:
· Added a new "Attribute" class that defines the following:
o tag
o value
o owner association
· Added a new "Annotation" class that defines the following:
o text
o owner association

• Added a new “Attribute” class that defines the following:
o tag
o value
o owner association
• Added a new “Annotation” class that defines the following:
o text
o owner association

The Observation class was not sufficient to capture the scope of the models that were part of the observation and also it didn't identify which measures either should be calculated or had been calculated once completely built. The changes here address these short-comings.

Discussion:

Summary of change:
· Added a new "ObservationScope" class that defines the following:
o scopeUri along with its format and allowable content
· Added 2 new associations to the Observation class
o one to ObservationScope
o and the other to SmmElement, but with a constraint to Category, CategoryRelationship or Measure. This allows to define the "to build" list based not only on specifying measures, but by category or even categoryRelationship.

• Added a new “ObservationScope” class that defines the following:
o scopeUri along with its format and allowable content
• Added 2 new associations to the Observation class
o one to ObservationScope
o and the other to SmmElement, but with a constraint to Category, CategoryRelationship or Measure. This allows to define the “to build” list based not only on specifying measures, but by category or even categoryRelationship.