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

Individuals without definition #859

Open
5 tasks done
l-emele opened this issue Sep 8, 2021 · 16 comments
Open
5 tasks done

Individuals without definition #859

l-emele opened this issue Sep 8, 2021 · 16 comments
Assignees
Labels
[B] restructure Restructuring existing parts of the ontology good first issue Good for newcomers meta issue Issue that collects information about topics and will be closed after detailled issues are solved. oeo-model changes the oeo-model module

Comments

@l-emele
Copy link
Contributor

l-emele commented Sep 8, 2021

Description of the issue

We have in oeo-model a lot of individuals without definition (sorted by types):

Type Individual Updated Definition
methodical focus econometric
methodical focus monte carlo
methodical focus spreadsheet
modus active
modus inactive
modus passive
software framework c++ #1869
software framework fortran #1869
software framework gams #1889
software framework gnu
software framework java #1869
software framework math prog
software framework matlab #1869
software framework modelica
software framework ms_excel
software framework php #1869
software framework python #1869
software framework r #1869
software framework ruby #1869
software framework vba #1869
uncertainty approach deterministic
uncertainty approach stochastic

At least some of them are not unambiguous without a definition. Just three examples:

  • Does csv only include comma-separated values or does csv any character-separated values?
  • What is the difference between passive and inactive?
  • Why is spreadsheet a methodical focus and not a data format or a software framework?

Ideas of solution

If you already have ideas for the solution describe them here

Workflow checklist

  • I discussed the issue with someone else than me before working on a solution
  • I already read the latest version of the workflow for this repository
  • The goal of this ontology is clear to me

I am aware that

  • every entry in the ontology should have a definition
  • classes should arise from concepts rather than from words
@l-emele l-emele added [B] restructure Restructuring existing parts of the ontology oeo-model changes the oeo-model module To do Issues that haven't got discussed yet labels Sep 8, 2021
@l-emele l-emele added this to the oeo-release-1.9.0 milestone Sep 8, 2021
@l-emele l-emele added the meta issue Issue that collects information about topics and will be closed after detailled issues are solved. label Sep 8, 2021
@l-emele
Copy link
Contributor Author

l-emele commented Sep 15, 2021

@christian-rli : I assigned you to this issue as most of the individuals are related to software and data.

@l-emele
Copy link
Contributor Author

l-emele commented Nov 19, 2021

@christian-rli @Ludee : Do you already have some ideas for this issue?

@christian-rli
Copy link
Contributor

We haven't gotten into this yet @l-emele . As @Ludee is getting into ontology deveopment now however, I think that this might be a good issue to begin with. I put it on our internal agenda.

@github-actions github-actions bot removed the To do Issues that haven't got discussed yet label Nov 23, 2021
@stale stale bot added the stale already discussed issues that haven't got worked on for a while label Dec 7, 2021
@stale stale bot removed the stale already discussed issues that haven't got worked on for a while label Feb 8, 2022
@l-emele
Copy link
Contributor Author

l-emele commented Feb 8, 2022

@Ludee : I assigned this issue now to you. Do you already have some proposals for definitions of these individuals?

@stale stale bot added the stale already discussed issues that haven't got worked on for a while label Mar 5, 2022
@l-emele
Copy link
Contributor Author

l-emele commented Mar 25, 2022

@OpenEnergyPlatform/oeo-domain-expert-energy-modelling @OpenEnergyPlatform/oeo-domain-expert-linked-open-data : Any suggestions for definitions? Maybe at least for some of these individuals? We do not necessarily have to implement all at once...

@stale stale bot removed the stale already discussed issues that haven't got worked on for a while label Apr 25, 2022
@l-emele
Copy link
Contributor Author

l-emele commented May 5, 2022

I think, that some of the individuals have the wrong type. I would describe c++, fortran, php, python etc not as software framework 1 but as programming language 2:

Footnotes

  1. A software framework is a Software that is generic and can be adapted to a specific application.

  2. IAO_0000025: A language in which source code is written that is intended to be executed/run by a software interpreter. Programming languages are ways to write instructions that specify what to do, and sometimes, how to do it. (Not yet imported from IAO into OEO.

@Ludee
Copy link
Member

Ludee commented May 10, 2022

I will start collecting good definitions now.
Not sure how to proceed with the import from IAO.

@chrwm
Copy link
Member

chrwm commented Sep 19, 2022

I'll remove the release milestone from the meta issue, as the sub-issues are tracked and discussions are still ongoing.

@stale stale bot removed the stale already discussed issues that haven't got worked on for a while label Sep 19, 2022
@chrwm chrwm removed this from the oeo-release-1.12.0 milestone Sep 19, 2022
@stale stale bot added the stale already discussed issues that haven't got worked on for a while label Oct 12, 2022
@stale stale bot removed the stale already discussed issues that haven't got worked on for a while label Dec 1, 2022
@stale stale bot added the stale already discussed issues that haven't got worked on for a while label Dec 20, 2022
@l-emele
Copy link
Contributor Author

l-emele commented Sep 26, 2023

In my view the following are not instances of software framework but programming languages

  • c++
  • fortran
  • java
  • php
  • python
  • r
  • ruby
  • vba

To me, it is hard to define, what differentiates each of these programming languages. But maybe it is enough, do specify where these programming languages come from. Also as the individuals are proper nouns or abbreviations I suggest to capitalise the labels. So here are some proposals for definitions:

  • C++: C++ is a programming languages designed by Bjarne Stroustrup and standardised by ISO/IEC.
  • Fortran: Fortran is a programming language designed by John Backus, developed by IBM and standardised by ISO/IEC.
  • Java: Java is a programming language designed by James Gosling and developed by Oracle.
  • PHP: PHP is a programming language designed by Rasmus Lerdorf.
  • Python: Python is a programming language designed by Guido van Rossum and developed by the Python Software Foundation.
  • R: R is a programming language designed by Ross Ihaka and Robert Gentleman and the R Core Team.
  • Ruby: Ruby is a programming language designed by Yukihiro Matsumoto.
  • VBA: VBA is a programming language based on Visual Basic and developed by Microsoft for use within the Microsoft Office software package.

Matlab is a special case, I think there are two entities to differentiate: A software framework and the programming language the software framework uses; Wikipedia describes it as: MATLAB (an abbreviation of "MATrix LABoratory" is a proprietary programming language and numeric computing environment developed by MathWorks. So I suggest two individuals:

  • Rename the existing matlab to Matlab software framework and define it as: The Matlab software framework is a proprietary software framework developed by MathWorks that uses the Matlab programming language.
  • Add an individual: Matlab programming language: The Matlab programming language is a programming language developed by MathWorks for use in the Matlab software framework.

Both individuals could get the alternative label Matlab. The reason to split Matlab into two is that users of the OEO can then differentiate. Also there is third-party that can use code written in the Matlab programming language, for example GNU Octave. R might be a similar case, but I do not now enough about that programming language.

Sources: Wikipedia pages of the respective programming languages.

@stale stale bot removed the stale already discussed issues that haven't got worked on for a while label Sep 26, 2023
@l-emele l-emele added this to the oeo-release-2.2.0 milestone Nov 21, 2023
@l-emele
Copy link
Contributor Author

l-emele commented Jun 27, 2024

For almost a year, no one reacted and especially no one objected to my proposals above. So I will implement the definitions for the programming languages now.

@stap-m
Copy link
Contributor

stap-m commented Jun 28, 2024

SWO unfortunately has no nice definitions for their classes, but contails classes for plenty of languages. We should map them, once we introduced the "skos:close to" annotation, see PR #1874

@l-emele
Copy link
Contributor Author

l-emele commented Jul 2, 2024

I updated the table in the issue start for the individuals we already updated.

Regarding the remaining:

  • class methodological focus with individuals monte carlo, econometric and spreadsheet => I think this whole concept needs a restart, I'll open a separate issue for that. => Revisit methodological focus #1885
  • gams: Like with Matlab, I think we need to differentiate here between the software framework and the programming language.
    • General Algebraic Modeling System: The General Algebraic Modeling System (GAMS) is a proprietary software framework developed by GAMS Development Corp. that uses the GAMS programming language. (Alternative label: GAMS)
    • GAMS programming language: The GAMS programming language is a programming language developed by GAMS Development Corp. for use in the General Algebraic Modeling System. (Alternative label: GAMS)
  • class uncertainty approach with individuals deterministic and stochastic => Sounds like qualities of models, I'll open a separate issue for that. => Revisit model descriptor and subclasses #1886

@l-emele
Copy link
Contributor Author

l-emele commented Jul 10, 2024

No one reacted yet, but as my gams proposal is the same pattern as with what we've done with matlab in interpret "no reaction" as "no objection" and will implement this to move forward.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[B] restructure Restructuring existing parts of the ontology good first issue Good for newcomers meta issue Issue that collects information about topics and will be closed after detailled issues are solved. oeo-model changes the oeo-model module
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants