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

input/output new properties the same as object/result in CreateAction? #655

Open
ljgarcia opened this issue Sep 29, 2023 · 3 comments
Open
Assignees

Comments

@ljgarcia
Copy link
Contributor

Original message by @ptsefton at #653 (comment)

BTW, also as an outsider though the properties input and output in particular ring alarm bells for me; these are semantically the same as or very close to, object and result on http://schema.org:CreateAction, as used here: https://www.researchobject.org/workflow-run-crate/profiles/process_run_crate. Not my project, but do you really need new terms?

@ljgarcia
Copy link
Contributor Author

input and output were proposed for the ComputationalWorkflow profile and later adopted as well by the ComptutationalTool profile. input and output are of type FormalParameter so (my understanding) they are meant to represent an abstraction rather than an actual thing. Making a parallel to functions and function calls, FormalParameter is a parameter used when defining the workflow/tool, not an argument used when the workflow/tool is actually used.
@nsjuty could you please follow up with ComputationalWorkflow group? You could also make the liaison with RO-Crates so we find out the way to go (hopefully a compatible way for both communities). Thanks.

@albangaignard
Copy link
Collaborator

@ptsefton, thanks for suggesting the reuse of object and result schema.org properties. Since these properties have for range Thing, I don't see anything againts refering to an instance of FormalParameter. So it would be ok for me to update the Bioschemas profiles with these schema.org properties.

The semantics would be a bit different since in Computational{Tool,Worflow} profiles, we focus on tool/workflows specifications and not their execution. My understanding of CreateAction is that it's more related to provenance metadata (what is actually done on a thing).

@stain, what is your opinion on the ComputationalWorkflow side ?

@stain
Copy link

stain commented Sep 9, 2024

On ComputationalWorkflow the reason we introduced a FormalParameter was because the input and are not the real thing/data, they are prototypes of that data. You could also consider a CreateAction that is in actionStatus http://schema.org/ PotentialActionStatus to be a prototype of the action -- in which case object is what the action would consume and result what it would produce. Now clearly result is there also a prototype (perhaps to a URL that does not work yet), but it's unclear if object is real or prototype.

The FormalParameter also gives space to provide a name/position to the parameter, although you could already do that using https://schema.org/Role (equivalent to roles in PROV-O).

Are you suggesting that in a ComputationalTool you talk about a potential execution, then you want to mix some real data inputs (e.g. --quiet) with prototypical inputs (some FASTQ sequence)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants