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>

# ShEx Version 2.2
IMPORT <Uri.shex>
IMPORT <Code.shex>
IMPORT <Date.shex>

IMPORT <Range.shex>
IMPORT <Group.shex>
IMPORT <string.shex>

IMPORT <String.shex>

IMPORT <Coding.shex>
IMPORT <Period.shex>
IMPORT <Device.shex>
IMPORT <boolean.shex>
IMPORT <dateTime.shex>
IMPORT <markdown.shex>

IMPORT <Boolean.shex>
IMPORT <Markdown.shex>
IMPORT <DateTime.shex>

IMPORT <Quantity.shex>
IMPORT <Evidence.shex>

IMPORT <Resource.shex>
IMPORT <ValueSet.shex>

IMPORT <Reference.shex>
IMPORT <canonical.shex>

IMPORT <Canonical.shex>

IMPORT <Identifier.shex>
IMPORT <Annotation.shex>
IMPORT <Expression.shex>
IMPORT <positiveInt.shex>

IMPORT <Attachment.shex>
IMPORT <UnsignedInt.shex>
IMPORT <PositiveInt.shex>

IMPORT <UsageContext.shex>
IMPORT <DeviceMetric.shex>

IMPORT <RelativeTime.shex>

IMPORT <ContactDetail.shex>
IMPORT <DomainResource.shex>
IMPORT <RelatedArtifact.shex>
IMPORT <BackboneElement.shex>

IMPORT <CodeableConcept.shex>
IMPORT <BackboneElement.shex>
IMPORT <CodeableReference.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]?;

    a [fhir:EvidenceVariable]?;
    fhir:nodeRole [fhir:treeRoot]?;
    fhir:url @<uri>?;                       # Canonical identifier for this 

    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 

    fhir:version @<String>?;                # Business version of the evidence 

                                            # variable 
    fhir:versionAlgorithm @<string>  OR 

    fhir:versionAlgorithm @<String>  OR 

    			@<Coding>  ?;  # How to compare versions
    fhir:name @<string>?;                   # Name for this evidence variable 

    fhir:name @<String>?;                   # Name for this evidence variable 

                                            # (computer friendly) 
    fhir:title @<string>?;                  # Name for this evidence variable 

    fhir:title @<String>?;                  # Name for this evidence variable 

                                            # (human friendly) 
    fhir:shortTitle @<string>?;             # Title for use in informal contexts
    fhir:status @<code> AND

    fhir:shortTitle @<String>?;             # Title for use in informal contexts
    fhir:citeAs @<Markdown>?;               # Display of how to cite this 
                                            # EvidenceVariable 
    fhir:status @<Code> AND

    	{fhir:v @fhirvs:publication-status};  # draft | active | retired | unknown
    fhir:experimental @<boolean>?;          # For testing purposes, not real 

    fhir:experimental @<Boolean>?;          # For testing only - never for real 

                                            # usage 
    fhir:date @<dateTime>?;                 # Date last changed
    fhir:publisher @<string>?;              # Name of the publisher/steward 

    fhir:date @<DateTime>?;                 # Date last changed
    fhir:author @<OneOrMore_ContactDetail>?;  # Who authored the content
    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 

    fhir:recorder @<OneOrMore_ContactDetail>?;  # Who entered the data for the 
                                            # evidence variable 
    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: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 

    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 

    fhir:copyright @<Markdown>?;            # Intellectual property ownership, 
                                            # may include restrictions on use 
    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 

    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 

    fhir:relatesTo @<OneOrMore_EvidenceVariable.relatesTo>?;  # Relationships to other Resources
    fhir:actual @<Boolean>?;                # Actual or conceptual
    fhir:definition @<CodeableReference>?;  # The meaning of the evidence 
                                            # variable 
    fhir:definitionModifier @<OneOrMore_EvidenceVariable.definitionModifier>?;  # Further specification of the 
                                            # definition 
    fhir:handling @<CodeableConcept>?;      # boolean | continuous | dichotomous 
                                            # | ordinal | polychotomous | 
                                            # time-to-event | not-specified 
    fhir:category @<OneOrMore_EvidenceVariable.category>?;  # A grouping for dichotomous, 
                                            # ordinal, or polychotomouos 
                                            # variables 
    fhir:conditional @<Expression>?;        # Condition determining whether the 
                                            # data will be collected 
    fhir:classifier @<OneOrMore_CodeableConcept>?;  # Classification
    fhir:dataStorage @<OneOrMore_EvidenceVariable.dataStorage>?;  # How the data element (value of the 
                                            # variable) is found 
    fhir:timing @<RelativeTime>?;           # When the variable is observed
    fhir:period @<Period>?;                 # Calendar-based timing when the 
                                            # variable is observed 
    fhir:constraint @<OneOrMore_EvidenceVariable.constraint>?;  # Limit on acceptability of data 
                                            # value 
    fhir:missingDataMeaning @<OneOrMore_CodeableConcept>?;  # How missing data can be interpreted
    fhir:unacceptableDataHandling @<OneOrMore_CodeableConcept>?;  # How erroneous data is processed

}  
# 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 

# A grouping for dichotomous, ordinal, or polychotomouos variables
<EvidenceVariable.category> EXTENDS @<BackboneElement> CLOSED {   
    fhir:name @<String>?;                   # Description of the grouping

    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 

    			(@<Reference>  AND {fhir:l @<Group> })  ?;  # Definition of the grouping

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

# Further specification of the definition
<EvidenceVariable.definitionModifier> EXTENDS @<BackboneElement> CLOSED {   
    fhir:code @<CodeableConcept>;           # Attribute of the definition

    fhir:value @<CodeableConcept>  OR 
    			@<Boolean>  OR 

    			@<Quantity>  OR 
    			@<Range>  ?;  # Definition of the grouping

    			@<Range>  OR 
    			@<Period>  OR 
    			@<RelativeTime>  OR 
    			(@<Reference>  AND {fhir:l @<Resource> })  OR 
    			@<Expression>  OR 
    			@<Uri>  ;  # Specification of the definition 
                                            # attribute 

}  
# 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 

# Relationships to other Resources
<EvidenceVariable.relatesTo> EXTENDS @<BackboneElement> CLOSED {   
    fhir:type @<CodeableConcept>;           # documentation | justification | 
                                            # citation | predecessor | successor 
                                            # | derived-from | depends-on | 
                                            # composed-of | part-of | amends | 
                                            # amended-with | appends | 
                                            # appended-with | cites | cited-by | 
                                            # comments-on | comment-in | 
                                            # contains | contained-in | corrects 
                                            # | correction-in | replaces | 
                                            # replaced-with | retracts | 
                                            # retracted-by | signs | similar-to 
                                            # | supports | supported-with | 
                                            # transforms | transformed-into | 
                                            # transformed-with | documents | 
                                            # specification-of | created-with | 
                                            # cite-as | reprint | reprint-of | 
                                            # summarizes 
    fhir:target @<Uri>  OR 
    			@<Attachment>  OR 
    			(@<Canonical>  AND {fhir:l @<Resource> })  OR 
    			(@<Reference>  AND {fhir:l @<Resource> })  OR 
    			@<Markdown>  ;  # The artifact that is related to 
                                            # this EvidenceVariable 

}  
# 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 

 
<EvidenceVariable.dataStorage.componentnull> CLOSED {   

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

# How the data element (value of the variable) is found
<EvidenceVariable.dataStorage> EXTENDS @<BackboneElement> CLOSED {   
    fhir:datatype @<CodeableConcept>?;      # Type of data used to express value 
                                            # of the variable 
    fhir:path @<String>?;                   # Where to find the data element in 
                                            # the dataset 
    fhir:delimiter @<String>?;              # Character(s) separating values in 
                                            # a string-based list 
    fhir:component @<OneOrMore_EvidenceVariable.dataStorage>?; 
}  
# Limit on acceptability of data value
<EvidenceVariable.constraint> EXTENDS @<BackboneElement> CLOSED {   
    fhir:conditional @<CodeableConcept>?;   # Condition determining whether this 
                                            # constraint applies 
    fhir:minimumQuantity @<Quantity>?;      # The lowest permissible value of 
                                            # the variable 
    fhir:maximumQuantity @<Quantity>?;      # The highest permissible value of 
                                            # the variable 
    fhir:earliestDateTime @<DateTime>?;     # The earliest permissible value of 
                                            # the variable 
    fhir:latestDateTime @<DateTime>?;       # The latest permissible value of 
                                            # the variable 
    fhir:minimumStringLength @<UnsignedInt>?;  # The lowest number of characters 
                                            # allowed for a value of the 
                                            # variable 
    fhir:maximumStringLength @<PositiveInt>?;  # The highest number of characters 
                                            # allowed for a value of the 
                                            # variable 
    fhir:code @<CodeableConcept>?;          # Rule for acceptable data values
    fhir:expression @<Expression>?;         # Rule for acceptable data values, 
                                            # as an Expression 
    fhir:expectedValueSet @<Reference> AND {fhir:l 
    			@<ValueSet> ? }?;  # List of anticipated values used to 
                                            # express value of the variable 
    fhir:expectedUnitsValueSet @<Reference> AND {fhir:l 
    			@<ValueSet> ? }?;  # List of anticipated values used to 
                                            # express units for the value of the 
                                            # variable 
    fhir:anyValueAllowed @<Boolean>?;       # Permissibility of unanticipated 
                                            # value used to express value of the 
                                            # variable 
}  

#---------------------- 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.relatesTo> CLOSED {
    rdf:first @<EvidenceVariable.relatesTo>  ;
    rdf:rest [rdf:nil] OR @<OneOrMore_EvidenceVariable.relatesTo> 

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

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

}
<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> 

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

}
#---------------------- 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"]