Clarifying https://nih-ncpi.github.io/ncpi-fhir-ig-2/module_overview.html

[mingward]

What were you reviewing?

https://nih-ncpi.github.io/ncpi-fhir-ig-2/module_overview.html

Should we look at this diagram? What does the arrow and diamond mean?
We tried to deduce and also looked at each profile's code, but we seemed to get different inferences based on the code.
For example. please see a snapshot of the diagram image below:

If we think the "arrow" means "1 or more", then an NCPI Study participant is related to

• 1 or more NCPI participants (The FHIR says exactly 1)
• 1 or more ResearchAccess Policies (The FHIR says 0 or more)
• 1 or more ResearchStudies (The FHIR says exactly 1)

Could you help us clarify this? Thank you!

[RobertJCarroll]

I think it's an "illustrative draft figure" at this point versus an "accurate technical diagram". Broadly, arrows are cardinality of 1 and diamonds are 0/1 or more. We can add this as an item to refine when we have finalized content.

[RadixSeven]

We should generate the diagrams from the FHIR shorthand source code. As figures are the part of a paper we read first, diagrams are the part of a standard people read first.

Broadly, arrows are cardinality of 1 and diamonds are 0/1 or more.

Do you mean that broadly, arrows are 1..1 and diamonds are 0..? where ? is undetermined between 1 and *.

[RobertJCarroll]

Are you aware of a tool that can generate the diagram from FSH? My other concern is such automatically generated diagrams tend to be hard to read; by curating them manually we can craft something that's more legible. EG, the goal of this main figure is to point people to read more details in the modules, not to describe the exact relationships among every entity. We need to align on expectations and clearly communicate them.

Arrows: 1..1 (though sometimes multiple arrows are condensed into one)
Diamonds: 0..* (though sometimes it's 1..*)