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

Definition for Program and Trial #598

Open
Gabriel-Besombes opened this issue Apr 15, 2024 · 1 comment
Open

Definition for Program and Trial #598

Gabriel-Besombes opened this issue Apr 15, 2024 · 1 comment
Labels
BrAPI-Core Related to BrAPI-Core Modify Documentation Documentation is changed but no technical change is needed

Comments

@Gabriel-Besombes
Copy link

Gabriel-Besombes commented Apr 15, 2024

Current available definitions :

Program : A BrAPI Program represents the high level organization or group who is responsible for conducting trials and studies. Things like Breeding Programs and Funded Projects are considered BrAPI Programs. A Program can contain multiple Trials. A Trial can contain multiple Studies.
Trial : Trials comprise of multiple studies. A "trial" in BrAPI represents an "investigation" in MIAPPE (Minimal Information about a Plant Phenotyping Experiment).
MIAPPE definition : Investigations are research programmes with defined aims. They can exist at various scales (for example, they could encompass a grant-funded programme of work, the various components comprising a peer-reviewed publication, or a single experiment).

Issues :

Overlap : There seems to be significant overlap between these two notions. It is difficult to know what is a Trial and what is a Program for communities that don't usually use these terms. Some things can be both. There is also some overlap of Trial with a general notion of dataset that isn't really defined and doesn't appear in "MIAPPE:Investigation".
Cardinality : The link Program -> Trials is one to many when there are examples of many to many in reality. A Trial can be funded partly through multiple programs for example.
Ambiguity : There is ambiguity on wether a Trial is linked to one or more publications and if the data in it is fixed or can evolve over time.

@BrapiCoordinatorSelby BrapiCoordinatorSelby added Modify Documentation Documentation is changed but no technical change is needed BrAPI-Core Related to BrAPI-Core labels Apr 15, 2024
@daveneti
Copy link

The concepts of Program, Trial and Study are very specific to the source data / business processses. We have also have use cases where a study has no trial and a study has a different program to its trial program.

I agree the defintiions need updating, but it might be difficult to come to a concenus.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
BrAPI-Core Related to BrAPI-Core Modify Documentation Documentation is changed but no technical change is needed
Projects
None yet
Development

No branches or pull requests

3 participants