This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "CohortSummary FHIR Resource Proposal"

From HL7Wiki
Jump to navigation Jump to search
(Created page with "{{subst::Template:FHIR Resource Proposal}}")
 
(migrate to Confluence)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
  
 
<div class="messagebox cleanup metadata">
 
<div class="messagebox cleanup metadata">
<div style="float: left;">[[Image:OpenHotTopic.GIF|35px| ]]</div>
+
<div style="float: left;">[[Image:OpenHotTopic.GIF|35px| ]]</div>Current version: https://confluence.hl7.org/display/FHIR/CohortSummary+FHIR+Resource+Proposal<div style="background:#F0F0F0">
<div style="background:#F0F0F0">
 
 
This page documents a [[:category:Pending FHIR Resource Proposal|Pending]] [[:category:FHIR Resource Proposal|FHIR Resource Proposal]]
 
This page documents a [[:category:Pending FHIR Resource Proposal|Pending]] [[:category:FHIR Resource Proposal|FHIR Resource Proposal]]
 
</div>
 
</div>
Line 13: Line 12:
  
  
=PutProposedResourceNameHere=
+
=CohortSummary=
  
<!-- Resource names should meet the following characteristics:
 
* Lower camel case
 
* U.S. English
 
* Domain-friendly
 
* Short
 
* Clear
 
* Unique
 
* Avoid non-universal abbreviations (e.g. URL would be ok)
 
* Be expressed as a noun
 
* Be consistent with other similar resources
 
-->
 
  
 
==Owning work group name==
 
==Owning work group name==
  
<!-- The name of the committee that is proposed to have responsibility for developing and maintaining the resources. -->
+
Clinical Decision Support
[[YourWorkGroupName]]
 
  
 
==Committee Approval Date:==
 
==Committee Approval Date:==
<i>Please enter the date that the committee approved this Resource proposal</i>
+
Initial PSS for EBMonFHIR project: June 22, 2018
 +
Resource Approval by CDS WG: May 7, 2019
  
 
==Contributing or Reviewing Work Groups==
 
==Contributing or Reviewing Work Groups==
  
<!-- Additional work groups that may have an interest in contributing to, or reviewing  the content of the resource (optional) -->
+
Clincial Quality Information
* Work Group Name
+
Biomedical Research and Regulation
* or link
 
* or "None"
 
  
 
==FHIR Resource Development Project Insight ID==
 
==FHIR Resource Development Project Insight ID==
  
<!-- Please specify the id of your work group’s PSS for doing FHIR work.  (If submitted but not yet approved, just write “pending”.) The link to the PSS template can be found here: http://gforge.hl7.org/gf/download/docmanfileversion/6832/9398/HL7FHIR_DSTUballotPSS-20120529.doc -->
+
1422
  
 
==Scope of coverage==
 
==Scope of coverage==
  
<!-- Define the full scope of coverage for the resource.  The scope must be clearly delineated such that it does not overlap with any other existing or expected resource.  The scope will be used to govern "what is the set of potential applications to consider when evaluating what elements are 'core' – i.e. in the 80%"
+
The scope of the CohortSummary resource is to describe the statistics about a group of entities, including associations of measured variables within the cohort.  
  
Scope should consider numerous aspects of breadth of scope, including:
+
Common types of statistics that will be reported includes means, medians, and proportions. Association statistics (such as correlation coefficient) will also be supported to report evidence about associations between observations.
* Subject: Human vs. non-human vs. non-patient (e.g. lab bench medicine)
+
 
* Disciplines: Environmental Health, Palliative, Respiratory, Psychology, Maternity, Clinical Research
+
Expressing summary characteristics for cohorts and evidence reports regarding associations is done throughout reporting of biomedical research, systematic reviews, and clinical reference across all disciplines.
* Delivery environment (Community, Geriatric, Home care, Emergency, Inpatient, Intensive, Neonatal, Pediatric, Primary)
 
* Locale: Country, region
 
  
As a rule, resources should encompass all of these aspects.
 
-->
 
  
 
==RIM scope==
 
==RIM scope==
Line 65: Line 47:
 
==Resource appropriateness==
 
==Resource appropriateness==
  
<!-- Does the resource meet the following characteristics?
+
Across the evidence-based medicine community (hundreds of thousands of people communicating the results of healthcare research through original research and systematic reviews and expressing the findings from a body of evidence), the summary of cohort characteristics and associations of variables is the primary method of expressing quantitative results. Standardization is necessary to support interoperability across the evidence-based medicine domain.
  
Must
 
* Represents a well understood, "important" concept in the business of healthcare
 
* Represents a concept expected to be tracked with distinct, reliable, unique ids
 
* Reasonable for the resource to be independently created, queried and maintained
 
  
Should
+
==Expected implementations==
* Declared interest in need for standardization of data exchange</span>
 
* Resource is expected to contain an appropriate number of "core" (non-extension) data elements (in most cases, somewhere in the range of 20-50)
 
* Have the characteristics of high cohesion & low coupling – need to explore whether coupling is good some places, not elsewhere – layers from Bo’s document
 
-->
 
  
==Expected implementations==
+
Many knowledge producers who express the biomedical research community knowledge will be the implementers using this resource. Examples of these knowledge producers include Agency for Healthcare Research and Quality (AHRQ), Centers for Disease Control and Prevention (CDC), Cochrane, Duodecim Medical Publications Ltd (from the Finnish Medical Society), EBSCO Health, MAGIC (stands for Making GRADE the Irresistible Choice), and numerous guideline development organizations.  In addition Johns Hopkins University and other Clinical and Translational Science Awards (CTSA) Program participants of the NIH National Center for Advancing Translational Sciences (NCATS) have been anticipating a "ClinicalProfile" FHIR Resource that will be functionally replaced with the CohortSummary resource.
  
<!--Key resources are justified by CCDA, for resources not deemed "key", what interest is there by implementers in using this particular resource. Provide named implementations if possible - ideally provide multiple independent implementations. -->
 
  
 
==Content sources==
 
==Content sources==
  
<!-- List all of the specifications (beyond those in the "standard" (FHIR_Design_Requirements_Sources) list of source specifications) that you’re planning to consult
+
None expected beyond the standard source specifications. However, the method for expressing citations (eg referring to a publication) is not yet defined and may require additional source specifications.
  
Are there any source specifications that you wish to consult but are concerned about access to or expertise to consider? -->
 
  
 
==Example Scenarios==
 
==Example Scenarios==
  
<!-- Provide a listing of the types of scenarios to be represented in the examples produced for this resource.  They should demonstrate the full scope of the resource and allow exercising of the resources capabilities (full element coverage, inclusion & omission of optional elements, repeating and singleton repeating elements, etc.) -->
+
The CohortSummary resource describes:
  
==Resource Relationships==
+
descriptions of the population, exposure, and measured variables that statistics are about
 +
the statistics for summary reporting of measured variables in the cohort where statistic datatype can include classification of the statistic type, sample size for the statistic, quantity of the statistic, a precision estimate (such as a 95% confidence interval), and ratings of the certainty of the statistic
 +
descriptions of the source of the effect estimates (eg author, citation, type of research)
  
<!-- What are the resources do you expect will reference this resource and in what context?
 
  
What resources do you expect this resource reference and in what context?
+
==Resource Relationships==
  
Note: These may be existing resources or "expected" resource
+
The CohortSummary Resource will reference Group Resource (to describe intended and actual population cohorts) and EvidenceVariable Resource (to describe exposures and measured variables)
  
Reference to resources is really only relevant at the "same or higher level" (Bo – fix this wording)
 
-->
 
  
 
==Resource Boundaries==
 
==Resource Boundaries==
  
<!-- What are the boundaries between this resource and other resources where implementers might have questions about which should be used when?
+
To be determined if implementers have questions that need explanations to support distinction and clarification.
 
+
CohortSummary will describe association statistics where multiple measured variables are analyzed with one exposure. A similarly structured resource (ComparativeEvidence) will describe comparative statistics where one measured variable is analyzed with multiple exposures.  The ComparativeEvidence and CohortSummary resources are purposefully created as separate resources to simplify the compound nesting relationships of exposures and measured variables for classifying statistics.
Are we confident existing implementations will be able to make the distinction? -->
 
  
 
==Timelines==
 
==Timelines==
  
<!-- Indicate the target date for having the resource complete from a committee perspective and ready for vetting and voting -->
+
First STU Ballot 2019 September
  
 
==gForge Users==
 
==gForge Users==
  
<!-- Identify the userids who will require commit access to gForge to maintain the resource.  (Ensure all users have registered for gForge.) -->
+
brynrhodes (github user) KhalidShahin-EBSCO (github user)
  
 
==When Resource Proposal Is Complete==
 
==When Resource Proposal Is Complete==

Latest revision as of 15:02, 31 October 2019



CohortSummary

Owning work group name

Clinical Decision Support

Committee Approval Date:

Initial PSS for EBMonFHIR project: June 22, 2018 Resource Approval by CDS WG: May 7, 2019

Contributing or Reviewing Work Groups

Clincial Quality Information Biomedical Research and Regulation

FHIR Resource Development Project Insight ID

1422

Scope of coverage

The scope of the CohortSummary resource is to describe the statistics about a group of entities, including associations of measured variables within the cohort.

Common types of statistics that will be reported includes means, medians, and proportions. Association statistics (such as correlation coefficient) will also be supported to report evidence about associations between observations.

Expressing summary characteristics for cohorts and evidence reports regarding associations is done throughout reporting of biomedical research, systematic reviews, and clinical reference across all disciplines.


RIM scope

Resource appropriateness

Across the evidence-based medicine community (hundreds of thousands of people communicating the results of healthcare research through original research and systematic reviews and expressing the findings from a body of evidence), the summary of cohort characteristics and associations of variables is the primary method of expressing quantitative results. Standardization is necessary to support interoperability across the evidence-based medicine domain.


Expected implementations

Many knowledge producers who express the biomedical research community knowledge will be the implementers using this resource. Examples of these knowledge producers include Agency for Healthcare Research and Quality (AHRQ), Centers for Disease Control and Prevention (CDC), Cochrane, Duodecim Medical Publications Ltd (from the Finnish Medical Society), EBSCO Health, MAGIC (stands for Making GRADE the Irresistible Choice), and numerous guideline development organizations. In addition Johns Hopkins University and other Clinical and Translational Science Awards (CTSA) Program participants of the NIH National Center for Advancing Translational Sciences (NCATS) have been anticipating a "ClinicalProfile" FHIR Resource that will be functionally replaced with the CohortSummary resource.


Content sources

None expected beyond the standard source specifications. However, the method for expressing citations (eg referring to a publication) is not yet defined and may require additional source specifications.


Example Scenarios

The CohortSummary resource describes:

descriptions of the population, exposure, and measured variables that statistics are about the statistics for summary reporting of measured variables in the cohort where statistic datatype can include classification of the statistic type, sample size for the statistic, quantity of the statistic, a precision estimate (such as a 95% confidence interval), and ratings of the certainty of the statistic descriptions of the source of the effect estimates (eg author, citation, type of research)


Resource Relationships

The CohortSummary Resource will reference Group Resource (to describe intended and actual population cohorts) and EvidenceVariable Resource (to describe exposures and measured variables)


Resource Boundaries

To be determined if implementers have questions that need explanations to support distinction and clarification. CohortSummary will describe association statistics where multiple measured variables are analyzed with one exposure. A similarly structured resource (ComparativeEvidence) will describe comparative statistics where one measured variable is analyzed with multiple exposures. The ComparativeEvidence and CohortSummary resources are purposefully created as separate resources to simplify the compound nesting relationships of exposures and measured variables for classifying statistics.

Timelines

First STU Ballot 2019 September

gForge Users

brynrhodes (github user) KhalidShahin-EBSCO (github user)

When Resource Proposal Is Complete

When you have completed your proposal, please send an email to FMGcontact@HL7.org

FMG Notes