Evidencevariable.shex

ShEx statement for evidencevariable

PREFIX fhir: <http://hl7.org/fhir/> 
PREFIX fhirvs: <http://hl7.org/fhir/ValueSet/>
PREFIX xsd: <http://www.w3.org/2001/XMLSchema#> 
PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> 

IMPORT <id.shex>
IMPORT <uri.shex>
IMPORT <code.shex>
IMPORT <date.shex>
IMPORT <Range.shex>
IMPORT <Group.shex>
IMPORT <string.shex>
IMPORT <Coding.shex>
IMPORT <Period.shex>
IMPORT <Device.shex>
IMPORT <boolean.shex>
IMPORT <dateTime.shex>
IMPORT <markdown.shex>
IMPORT <Quantity.shex>
IMPORT <Evidence.shex>
IMPORT <Reference.shex>
IMPORT <canonical.shex>
IMPORT <Identifier.shex>
IMPORT <Annotation.shex>
IMPORT <Expression.shex>
IMPORT <positiveInt.shex>
IMPORT <UsageContext.shex>
IMPORT <DeviceMetric.shex>
IMPORT <ContactDetail.shex>
IMPORT <DomainResource.shex>
IMPORT <RelatedArtifact.shex>
IMPORT <BackboneElement.shex>
IMPORT <CodeableConcept.shex>


start=@<EvidenceVariable> AND {fhir:nodeRole [fhir:treeRoot]}

# A definition of an exposure, outcome, or other variable
<EvidenceVariable> EXTENDS @<DomainResource> CLOSED {   

    a [fhir:EvidenceVariable]?;
    fhir:nodeRole [fhir:treeRoot]?;

    fhir:url @<uri>?;                       # Canonical identifier for this 
                                            # evidence variable, represented as 
                                            # a URI (globally unique) 
    fhir:identifier @<OneOrMore_Identifier>?;  # Additional identifier for the 
                                            # evidence variable 
    fhir:version @<string>?;                # Business version of the evidence 
                                            # variable 
    fhir:versionAlgorithm @<string>  OR 
    			@<Coding>  ?;  # How to compare versions
    fhir:name @<string>?;                   # Name for this evidence variable 
                                            # (computer friendly) 
    fhir:title @<string>?;                  # Name for this evidence variable 
                                            # (human friendly) 
    fhir:shortTitle @<string>?;             # Title for use in informal contexts
    fhir:status @<code> AND
    	{fhir:v @fhirvs:publication-status};  # draft | active | retired | unknown
    fhir:experimental @<boolean>?;          # For testing purposes, not real 
                                            # usage 
    fhir:date @<dateTime>?;                 # Date last changed
    fhir:publisher @<string>?;              # Name of the publisher/steward 
                                            # (organization or individual) 
    fhir:contact @<OneOrMore_ContactDetail>?;  # Contact details for the publisher
    fhir:description @<markdown>?;          # Natural language description of 
                                            # the evidence variable 
    fhir:note @<OneOrMore_Annotation>?;     # Used for footnotes or explanatory 
                                            # notes 
    fhir:useContext @<OneOrMore_UsageContext>?;  # The context that the content is 
                                            # intended to support 
    fhir:purpose @<markdown>?;              # Why this EvidenceVariable is 
                                            # defined 
    fhir:copyright @<markdown>?;            # Use and/or publishing restrictions
    fhir:copyrightLabel @<string>?;         # Copyright holder and year(s)
    fhir:approvalDate @<date>?;             # When the resource was approved by 
                                            # publisher 
    fhir:lastReviewDate @<date>?;           # When the resource was last 
                                            # reviewed by the publisher 
    fhir:effectivePeriod @<Period>?;        # When the resource is expected to 
                                            # be used 
    fhir:author @<OneOrMore_ContactDetail>?;  # Who authored the content
    fhir:editor @<OneOrMore_ContactDetail>?;  # Who edited the content
    fhir:reviewer @<OneOrMore_ContactDetail>?;  # Who reviewed the content
    fhir:endorser @<OneOrMore_ContactDetail>?;  # Who endorsed the content
    fhir:relatedArtifact @<OneOrMore_RelatedArtifact>?;  # Additional documentation, 
                                            # citations, etc 
    fhir:actual @<boolean>?;                # Actual or conceptual
    fhir:characteristic @<OneOrMore_EvidenceVariable.characteristic>?;  # A defining factor of the 
                                            # EvidenceVariable 
    fhir:handling @<code> AND
    	{fhir:v @fhirvs:variable-handling}?;  # continuous | dichotomous | ordinal 
                                            # | polychotomous 
    fhir:category @<OneOrMore_EvidenceVariable.category>?;  # A grouping for ordinal or 
                                            # polychotomous variables 
}  

# Used to specify how two or more characteristics are combined
<EvidenceVariable.characteristic.definitionByCombination> EXTENDS @<BackboneElement> CLOSED {   
    fhir:code @<code> AND
    	{fhir:v @fhirvs:characteristic-combination};  # all-of | any-of | at-least | 
                                            # at-most | statistical | net-effect 
                                            # | dataset 
    fhir:threshold @<positiveInt>?;         # Provides the value of "n" when 
                                            # "at-least" or "at-most" codes are 
                                            # used 
    fhir:characteristic @<OneOrMore_EvidenceVariable.characteristic>;  # A defining factor of the 
                                            # characteristic 
}  

# Defines the characteristic using type and value
<EvidenceVariable.characteristic.definitionByTypeAndValue> EXTENDS @<BackboneElement> CLOSED {   
    fhir:type @<CodeableConcept>;           # Expresses the type of 
                                            # characteristic 
    fhir:method @<OneOrMore_CodeableConcept>?;  # Method for how the characteristic 
                                            # value was determined 
    fhir:device @<Reference> AND {fhir:link 
    			@<Device> OR 
    			@<DeviceMetric> ? }?;  # Device used for determining 
                                            # characteristic 
    fhir:value @<CodeableConcept>  OR 
    			@<boolean>  OR 
    			@<Quantity>  OR 
    			@<Range>  OR 
    			@<Reference>  OR 
    			@<id>  ;  # Defines the characteristic when 
                                            # coupled with characteristic.type 
    fhir:offset @<CodeableConcept>?;        # Reference point for valueQuantity 
                                            # or valueRange 
}  

# A grouping for ordinal or polychotomous variables
<EvidenceVariable.category> EXTENDS @<BackboneElement> CLOSED {   
    fhir:name @<string>?;                   # Description of the grouping
    fhir:value @<CodeableConcept>  OR 
    			@<Quantity>  OR 
    			@<Range>  ?;  # Definition of the grouping
}  

# A defining factor of the EvidenceVariable
<EvidenceVariable.characteristic> EXTENDS @<BackboneElement> CLOSED {   
    fhir:linkId @<id>?;                     # Label for internal linking
    fhir:description @<markdown>?;          # Natural language description of 
                                            # the characteristic 
    fhir:note @<OneOrMore_Annotation>?;     # Used for footnotes or explanatory 
                                            # notes 
    fhir:exclude @<boolean>?;               # Whether the characteristic is an 
                                            # inclusion criterion or exclusion 
                                            # criterion 
    fhir:definitionReference @<Reference> AND {fhir:link 
    			@<Evidence> OR 
    			@<EvidenceVariable> OR 
    			@<Group> ? }?;  # Defines the characteristic 
                                            # (without using type and value) by 
                                            # a Reference 
    fhir:definitionCanonical @<canonical>?;  # Defines the characteristic 
                                            # (without using type and value) by 
                                            # a Canonical 
    fhir:definitionCodeableConcept @<CodeableConcept>?;  # Defines the characteristic 
                                            # (without using type and value) by 
                                            # a CodeableConcept 
    fhir:definitionExpression @<Expression>?;  # Defines the characteristic 
                                            # (without using type and value) by 
                                            # an expression 
    fhir:definitionId @<id>?;               # Defines the characteristic 
                                            # (without using type and value) by 
                                            # an id 
    fhir:definitionByTypeAndValue @<EvidenceVariable.characteristic.definitionByTypeAndValue>?;  # Defines the characteristic using 
                                            # type and value 
    fhir:definitionByCombination @<EvidenceVariable.characteristic.definitionByCombination>?;  # Used to specify how two or more 
                                            # characteristics are combined 
    fhir:instances @<Quantity>  OR 
    			@<Range>  ?;  # Number of occurrences meeting the 
                                            # characteristic 
    fhir:duration @<Quantity>  OR 
    			@<Range>  ?;  # Length of time in which the 
                                            # characteristic is met 
    fhir:timeFromEvent @<OneOrMore_EvidenceVariable.characteristic.timeFromEvent>?;  # Timing in which the characteristic 
                                            # is determined 
}  

# Timing in which the characteristic is determined
<EvidenceVariable.characteristic.timeFromEvent> EXTENDS @<BackboneElement> CLOSED {   
    fhir:description @<markdown>?;          # Human readable description
    fhir:note @<OneOrMore_Annotation>?;     # Used for footnotes or explanatory 
                                            # notes 
    fhir:event @<CodeableConcept>  OR 
    			@<Reference>  OR 
    			@<dateTime>  OR 
    			@<id>  ?;  # The event used as a base point 
                                            # (reference point) in time 
    fhir:quantity @<Quantity>?;             # Used to express the observation at 
                                            # a defined amount of time before or 
                                            # after the event 
    fhir:range @<Range>?;                   # Used to express the observation 
                                            # within a period before and/or 
                                            # after the event 
}  

#---------------------- Cardinality Types (OneOrMore) -------------------

<OneOrMore_Identifier> CLOSED {
    rdf:first @<Identifier>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_Identifier> 
}

<OneOrMore_ContactDetail> CLOSED {
    rdf:first @<ContactDetail>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_ContactDetail> 
}

<OneOrMore_Annotation> CLOSED {
    rdf:first @<Annotation>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_Annotation> 
}

<OneOrMore_UsageContext> CLOSED {
    rdf:first @<UsageContext>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_UsageContext> 
}

<OneOrMore_RelatedArtifact> CLOSED {
    rdf:first @<RelatedArtifact>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_RelatedArtifact> 
}

<OneOrMore_EvidenceVariable.characteristic> CLOSED {
    rdf:first @<EvidenceVariable.characteristic>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_EvidenceVariable.characteristic> 
}

<OneOrMore_EvidenceVariable.category> CLOSED {
    rdf:first @<EvidenceVariable.category>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_EvidenceVariable.category> 
}

<OneOrMore_CodeableConcept> CLOSED {
    rdf:first @<CodeableConcept>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_CodeableConcept> 
}

<OneOrMore_EvidenceVariable.characteristic.timeFromEvent> CLOSED {
    rdf:first @<EvidenceVariable.characteristic.timeFromEvent>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_EvidenceVariable.characteristic.timeFromEvent> 
}

#---------------------- Value Sets ------------------------

# Logical grouping of characteristics.
fhirvs:characteristic-combination ["all-of" "any-of" "at-least" "at-most" "statistical" "net-effect" "dataset"]

# The lifecycle status of an artifact.
fhirvs:publication-status ["draft" "active" "retired" "unknown"]

# The handling of the variable in statistical analysis for exposures or outcomes (E.g. Dichotomous, Continuous, Descriptive).
fhirvs:variable-handling ["continuous" "dichotomous" "ordinal" "polychotomous"]