Skip to main content

shr.core Code Systems


Description TBD

Code Display
disease A disorder of structure or function in a human, animal, or plant, especially one that produces specific signs or symptoms or that affects a specific location and is not simply a direct result of physical injury.
functional_impairment A disability experienced by the subject.
structural_abnormality An abnormality of physiologic structure.
concern Something the subject is worried about, which may or may not have yet been manifested. The object of the concern does not have to be a medical disorder.
symptom A sign or manifestation of a deeper cause, of known or unknown etiology, e.g. pain or ringing in the ears.
adverse_reaction An adverse reaction to an intervention.


Description TBD

Code Display
preferred_code The preferred, standardized code for interoperability purposes. There should be only one coding in a CodeableConcept with this tag.
source_code The code found in the information source for this entry, e.g., the raw, original, or first encoding.
user_selected_code The code was directly selected by the user, as opposed to being determined after the fact via interpretation of notes or natural language processing.
derived_code The code was determined after-the-fact from source data, either through translation, or via interpretation of free text (by human or machine).
category_code Indicates the code is a less specific term or a categorization of the source or standard code, i.e., a hypernym. For example, a code for 'vital sign' in the context of a body weight measurement would be a category code. Category codes can be useful for search and query purposes.
coded_expression The code is an expression in an expression language defined by the CodeSystem
default_code The code was supplied by the system by default, because no specific coded value was available.


Description TBD

Code Display
past A time or time period in the indefinite past
many_years_ago Many years ago
several_years_ago Several years ago
one_year_ago About a year ago
months_ago Several months ago
weeks_ago Several weeks ago
days_ago Several days ago
hours_ago Several hours ago
minutes_ago Several minutes ago
preexisting At a time previous to the current encounter or admission
now Now, currently, presently continuing or ongoing
minutes_hence Several minutes from now
hours_hence Several hours from now
days_hence Several days from now
weeks_hence Several weeks from now
months_hence Several months from now
one_year_hence About a year from now
several_years_hence Several years from now
many_years_hence Many years from now
future A time or time period in the indefinite future


Description TBD

Code Display
many_years Many years
several_years Several years
one_year About a year
months Several months but less than a year
weeks Several weeks but less than a month
days Several days but less than a week
hours Several hours but less than a day
minutes Several minutes but less than an hour
seconds Several seconds but less than a minute


Description TBD

Code Display
never Never
less_than_yearly Less than yearly
yearly Yearly
mot_yearly More than once yearly
monthly Monthly
weekly Weekly
mto_weekly More than once weekly
daily Daily
mto_daily More than once daily
hourly Hourly
mto_hourly More than once hourly
minutely Every minute
continuously Continuously


Code set indicating the frequency of an event in qualitative terms.

Code Display
always Virtually always or every time
usually Frequently or often
sometimes Occasionally or sometimes
rarely Rarely
never Never


Code set indicating yes or no.

Code Display
yes Yes, or true
no No, or false


Code set indicating yes, no, or unknown.

Code Display
yes Yes, or true
no No, or false
unknown Unknown


Description TBD

Code Display
very_high Very high
high High
moderate Moderate/Intermediate or Borderline
low Low
very_low Very low


The likelihood of an event or state, expressed qualitatively. Qualitative likelihoods are associated with judgments and assessments. Values are based on US Intelligence Community's standard language used to describe judgements of likelihood.

Code Display
definitely With certainty or near-complete certainty, an event that definitely has or almost certainly will happen
very_likely Very likely, highly probable, e.g., an event with more than 80% but less than 100% likelihood
likely Likely or probable, e.g., an event with 60% to 80% likelihood
even_chance Roughly equal chance or even odds of happening, between 40% and 60% probability
unlikely Not likely or improbable, e.g., an event with 20% to 40% likelihood
very_unlikely Very unlikely, highly improbable, e.g., an event with less than 20% but non-zero likelihood


Description TBD

Code Display
primary The first or primary item or alterative in a preference list.
secondary The second or backup preference.
third_or_lower An alternative to primary and secondard choices in a preference list.


What type of place is found at a given location. More than one descriptor may be applicable.

Code Display
work At or during work, in a workplace setting.
home At home
residental In a residential setting
school A primary or secondary school
vehicle In a parked or moving vehicle
office An non-manufacturing, indoor business setting
factory A manufacturing-oriented business setting
business A place of business
restaurant A setting where food is served
food_prep A place where food is prepared
worksite Workplace that is primarily outdoors
manufacturing A setting where manufacturing takes place
owned A building or residence that is owned
rental A building or residence that is rented
dorm Shared (unassisted) living residence, such as a dormitory or fraternity
foster Foster care group home
assisted Assisted living or independent living facility
snf Skilled nursing facility or other Long-Term Care
shelter Homeless or other type of shelter
hotel Hotel or motel
psh Permanent supportive housing for formerly homeless persons (such as SHP, S+C, or SRO Mod Rehab)
psych Psychiatric hospital or other psychiatric facility
detox Substance abuse treatment facility or detox center
prison Individual resides in a correctional facility, state hospital, jail, prison, youth authority facility, juvenile hall, boot camp or Boys Ranch.
transition Transitional housing, residential provier program, or any type of halfway house
squat A homeless camp, abandoned building, shantytown, bus/train/subway station/airport, or squatter area
outdoors Outside of any shelter, e.g., on a street
agricultural Agricultural setting
farm A farm with livestock
battlefield On a battlefield
deployed Deployed to a military camp or area
ship On a boat
airplane On an airplane
submarine Aboard a submarine


A simple performance grading scale. Also useful for grading quality.

Code Display
excellent Excellent
very_good Very good
good Good
fair Fair
poor Poor