Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update annnotations on gist:hasAccuracy #1146

Open
rjyounes opened this issue Aug 13, 2024 · 8 comments
Open

Update annnotations on gist:hasAccuracy #1146

rjyounes opened this issue Aug 13, 2024 · 8 comments
Assignees
Labels
status: fast track A low impact change for which a PR can be submitted without group discussion

Comments

@rjyounes
Copy link
Collaborator

The skos:definition should not be limited to magnitudes. A measuring instrument or a measurement event could also have an accuracy.

Current:

gist:hasAccuracy
	a
		owl:ObjectProperty ,
		owl:FunctionalProperty
		;
	rdfs:range gist:Magnitude ;
	skos:definition "Relates a magnitude to the accuracy of its numeric value."^^xsd:string ;
	skos:example "Temperature accurate to tenth of a degree C; length accurate to the nearest centimeter."^^xsd:string ;
	skos:prefLabel "has accuracy"^^xsd:string ;
	skos:scopeNote """A typical way to use accuracy is to have it represent 2 standard deviations of the distribution of measurement errors. With this convention, when the measurement method is well-calibrated (has an average error of zero) and its errors have a normal distribution, there is a 95% chance that the actual error in measurement, in either direction, is less than the accuracy.

Note that the unit of measure of the accuracy has to be compatible with the unit of measure of the original magnitude (e.g. something measured in meters could have a accuracy in terms of millimeters or any other unit that measures distance)."""^^xsd:string ;
	.

Proposed:

gist:hasAccuracy
	a
		owl:ObjectProperty ,
		owl:FunctionalProperty
		;
	rdfs:range gist:Magnitude ;
        gist:domainIncludes gist:Magnitude ;
	skos:definition "Relates a resource such as a magnitude to the accuracy of its numeric value."^^xsd:string ;
	skos:example "Temperature accurate to tenth of a degree C; length accurate to the nearest centimeter."^^xsd:string ;
	skos:prefLabel "has accuracy"^^xsd:string ;
        skos:scopeNote "Could also apply to measurement events (activities) or measuring instruments." ;
	skos:scopeNote """A typical way to use accuracy is to have it represent 2 standard deviations of the distribution of measurement errors. With this convention, when the measurement method is well-calibrated (has an average error of zero) and its errors have a normal distribution, there is a 95% chance that the actual error in measurement, in either direction, is less than the accuracy.

Note that the unit of measure of the accuracy has to be compatible with the unit of measure of the original magnitude (e.g. something measured in meters could have a accuracy in terms of millimeters or any other unit that measures distance)."""^^xsd:string ;
	.
@MichaelSullivanArchitect
Copy link

@rjyounes rjyounes added status: fast track A low impact change for which a PR can be submitted without group discussion and removed status: fast track A low impact change for which a PR can be submitted without group discussion labels Aug 22, 2024
@rjyounes rjyounes added the status: fast track A low impact change for which a PR can be submitted without group discussion label Aug 22, 2024
@rjyounes rjyounes moved this from In Triage to To Do in gist Version 13.1.0 Aug 22, 2024
@rjyounes
Copy link
Collaborator Author

Fix with #1149.

@MichaelSullivanArchitect

Is there an example of an instance of an "accuracy" magnitude in the style of "plus or minus 5%" ?

@uscholdm
Copy link
Contributor

Is there an example of an instance of an "accuracy" magnitude in the style of "plus or minus 5%" ?

No, but that is an interesting idea. We do have something similar in the operators ontology. See the properties:

  • hasTargetValue
  • hasPercentVariation
  • hasAbsoluteVariation

@MichaelSullivanArchitect
Copy link

@uscholdm
Copy link
Contributor

The second scopeNote is far more technical and detailed than is the norm for gist. I read it several times, I have a math background, and I still can't work out exactly what it means or how to make use of it. If this information is likely to be useful to gist users, I propose to use rdf:seeAlso to a link that has a good explanation. In the meantime, here is my proposal:

gist:hasAccuracy
	a
		owl:ObjectProperty ,
		owl:FunctionalProperty
		;
	rdfs:range gist:Magnitude ;
        gist:domainIncludes gist:Magnitude ;
	skos:definition "Relates a resource such as a magnitude to the accuracy of its numeric value."^^xsd:string ;
	skos:example "Temperature accurate to tenth of a degree C; length accurate to the nearest centimeter."^^xsd:string ;
	skos:prefLabel "has accuracy"^^xsd:string ;
        skos:scopeNote "Could also apply to measurement events (activities) or measuring instruments." ;
	skos:scopeNote "Note that the unit of measure of the accuracy has to be compatible with the unit of measure of the original magnitude (e.g. something measured in meters could have a accuracy in terms of millimeters or any other unit that measures distance)."^^xsd:string ;
	.

@rjyounes
Copy link
Collaborator Author

I agree that the original is too technical. Do you think "compatible" needs to be elaborated on or is it self-explanatory enough?

@uscholdm
Copy link
Contributor

something measured in meters could have a accuracy in terms of millimeters or any other unit that measures distance

It already is explained, to wit:

"something measured in meters could have a accuracy in terms of millimeters or any other unit that measures distance"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
status: fast track A low impact change for which a PR can be submitted without group discussion
Projects
Status: To Do
Development

No branches or pull requests

3 participants