JIRA Issue FIBO Foundations FTF2-23
Proposed Resolution
Issue Description: Augment the Analytics ontology (originally from FIBO IND) with Expression, Formula,
and Variable
Proposed Resolution
Discussion
The original Analytics ontology included with the FIBO IND specification included classes describing
measures and statistical measures. This issue merges that ontology into the main FIBO FND
Specification and augments the ontology to provide additional features needed in for Business Entities,
Indices and Indicators, Securities, and additional ontologies to be integrated into the FIBO family of
specifications over time. Some of the properties of the original Analytics classes referenced dates, such
as applicable start and end dates, calendar years for which the measures are appropriate, and so forth.
These need to be revised to reference the new FND FinancialDates ontology for more accurate and
complete definition. In addition, several new classes and properties for Expression, Formula, and
Variable are required to support the forthcoming SEC/Securities specification.
Model Changes
The following changes are to be made to the model originally submitted with the FIBO IND specification.
The corresponding diagrams and tables are generated from the model and are described in the section
which follows.
A.
Modifications to the date-specific model elements specified in the Analytics Ontology
1. Add a subclassOf inheritance relationship between Measure and Reference from the Relations
ontology.
2. Import the FinancialDates ontology into Analytics (owl:imports)
3. Make the hasMeasurementDate property a subproperty of hasDateValue from FinancialDates
and change the range from xsd:dateTime to dateValue from FinancialDates
4. Make the hasApplicablePeriodStart property a subproperty of hasDateTimeValue from
FinancialDates
5. Make the hasApplicablePeriodEnd property a subproperty of hasDateTimeValue from
FinancialDates
6. Add a new object property hasApplicableDatePeriod, with label “has applicable date period”,
definition “a predicate indicating the dates for which the statistical measure is applicable”,
domain of StatisticalMeasure, range of DatePeriod from FinancialDates and subproperty
relationship with hasDatePeriod from FinancialDates, which provides an alternative to the
properties described in 4 and 5, above
1
7. Change the property “forYear” from being a datatype property to being an object property;
change its label to “for calendar year”, and change its range to ExplicitDatePeriod from
FinancialDates; delete the annotation indicating that the range will be replaced with something
from DTV when available
B. Additions of analytical model elements to the Analytics Ontology
1. Add a Variable class, with label “variable” and definition “a symbol that represents a parameter
in a formula or expression”, as a child of Reference (Relations)
2. Add a Constant class, with label “constant” and definition “a symbol that represents a constant
in a formula or expression”, as a child of Reference (Relations)
3. Add an object property hasArgument with label “has argument” and definition “indicates a
specific input to a function, formula or expression, also known as an independent variable”, as a
subproperty of “has” (Relations). This property has a domain and range of Reference (Relations)
implemented in VOM via a proxy class for Reference having an <<about>> relation to Reference
(Relations)
4. Add an Expression class, with label “expression” and definition “a finite combination of symbols
that are well-formed according to applicable rules”, as a child of Reference (Relations), and as a
child of the set of things that have min 0 argument whose values are variables (i.e.,
hasArgument min 0 onClass Variable) and as a child of the set of things that have min 0
argument whose values are constants (i.e., hasArgument min 0 onClass Variable)
5. Add an object property hasExpression, with label “has expression” and definition “indicates a
mathematical or other formal expression, which may be part of a formula”, whose range is
Expression, whose domain is Reference and which is a subproperty of “has” (Relations)
6. Add a Formula class, with label “formula” and definition “a general fact or rule expressed in
letters and symbols; may consist of one or more expressions”, adapted from
http://www.merriam-webster.com/dictionary/formula, as a child of Reference (Relations), and
as a child of the set of things that have at least one expression whose values are expressions
(i.e., hasExpression someValuesFrom Expression)
7. Add an object property hasFormula, with label “has formula” and definition “indicates a concise
way of expressing information symbolically, as in a mathematical or chemical formula”, whose
range is Formula and is a subproperty of “has” (Relations)
8. Revise the metadata (versionIRI, changeNote, dependsOn), entity declarations and namespace
definitions in Analytics accordingly
2
Specification Changes
Add a new sub-clause 10.1.3 to the Utilities Module, sub-clause 10.1, for the Analytics
Ontology
A. Revise Table 8.3 to include the ontology prefix (fibo-fnd-utl-alx) and IRI
(http://www.omg.org/spec/EDMC-FIBO/FND/Utilities/Analytics/) to the table.
B. Add a new sub-clause 10.1.3, titled “Analytics Ontology”:
1. Under the title for sub-clause 10.1.3, replicate the text from the “sm:fileAbstract”
annotation metadata element in the Analytics ontology.
2. Incorporate the following figure, Figure 10.8 (the figure number may change if other issue
resolutions cause the addition or removal of the existing Figures 10.1 through 10.7) with the
diagram, included below, which has been copied directly from the source model for the
Analytics ontology, and is identified as “Measures Concepts”. This figure is a replacement
for the original Measures figure from the version of this ontology submitted with IND.
3. Incorporate the following figure, Figure 10.9 (the figure number may change if other issue
resolutions cause the addition or removal of the existing Figures 10.1 through 10.7) with the
3
diagram, included below, which has been copied directly from the source model for the
Analytics ontology, and is identified as “Expressions and Formulae”.
In sub-clause 10.1.3 add a new Table 10.7 “Analytics Ontology Metadata”. The content of this table is
generated from the Analytics ontology.
In sub-clause 10.1.3 add a new Table 10.8 “Analytics Details”. The content of this table is generated from
the Analytics ontology.
4