Inputevents
The inputevents table
Table source: MetaVision ICU database.
Table purpose: Input data for patients.
Number of rows: 8,978,893
Links to:
- patients on
subject_id
- admissions on
hadm_id
- icustays on
stay_id
- d_items on
itemid
Brief example
The original source database recorded input data using two tables: RANGESIGNALS and ORDERENTRY. These tables do not appear in MIMIC as they have been merged to form the INPUTEVENTS table. RANGESIGNALS contains recorded data elements which last for a fixed period of time. Furthermore, the RANGESIGNALS table recorded information for each component of the drug separately. For example, for a norepinephrine administration there would be two components: a main order component (norepinephrine) and a solution component (NaCl). The starttime
and endtime
of RANGESIGNALS indicated when the drug started and finished. Any change in the drug rate would result in the current infusion ending, and a new starttime
being created.
Let’s examine an example of a patient being given norepinephrine.
Item | starttime |
endtime |
rate |
rateuom |
orderid |
linkorderid |
---|---|---|---|---|---|---|
Norepinephrine | 18:20 | 18:25 | 1 | mcg/kg/min | 8003 | 8003 |
NaCl | 18:20 | 18:25 | 10 | ml/hr | 8003 | 8003 |
Norepinephrine | 18:25 | 20:00 | 2 | mcg/kg/min | 8020 | 8003 |
NaCl | 18:25 | 20:00 | 20 | ml/hr | 8020 | 8003 |
The starttime
for the solution (NaCl) and the drug (norepinephrine) would be 18:20. The rate of the drug is 1 mcg/kg/min, and the rate of the solution is 10 mL/hr. The nurse decides to increase the drug rate at 18:25 to 2 mcg/kg/min. As a result, the endtime
for the two rows corresponding to the solution (NaCl and norepinephrine) is set to 18:25. Two new rows are generated with a starttime
of 18:25. These two new rows would continue until either (i) the drug rate was changed or (ii) the drug was delivery was discontinued. The orderid
column is used to group drug delivery with rate of delivery. In this case, we have NaCl and norepinephrine in the same bag delivered at the same time - as a result their orderid
is the same (8003). When the rate is changed, a new orderid
is generated (8020). The column linkorderid
can be used to link this drug across all administrations, even when the rate is changed. Note also that linkorderid
is always equal to the first orderid
which occurs for the solution, as demonstrated in the example above.
Important considerations
- For Metavision data, there is no concept of a volume in the database: only a
rate
. All inputs are recorded with astarttime
and anendtime
. As a result, the volumes in the database for Metavision patients are derived from the rates. Furthermore, exact start and stop times for the drugs are easily deducible. - A bolus will be listed as ending one minute after it started, i.e.
endtime
:starttime
+ 1 minute
Table columns
Name | Postgres data type |
---|---|
subject_id | INT |
hadm_id | INT |
stay_id | INT |
caregiver_id | INTEGER |
starttime | TIMESTAMP(0) |
endtime | TIMESTAMP(0) |
storetime | TIMESTAMP(0) |
itemid | INT |
amount | DOUBLE PRECISION |
amountuom | VARCHAR(30) |
rate | DOUBLE PRECISION |
rateuom | VARCHAR(30) |
orderid | BIGINT |
linkorderid | BIGINT |
ordercategoryname | VARCHAR(100) |
secondaryordercategoryname | VARCHAR(100) |
ordercomponenttypedescription | VARCHAR(200) |
ordercategorydescription | VARCHAR(50) |
patientweight | DOUBLE PRECISION |
totalamount | DOUBLE PRECISION |
totalamountuom | VARCHAR(50) |
isopenbag |
SMALLINT |
statusdescription | VARCHAR(30) |
originalamount | DOUBLE PRECISION |
originalrate | DOUBLE PRECISION |
Detailed Description
subject_id
, hadm_id
, stay_id
Identifiers which specify the patient: subject_id
is unique to a patient, hadm_id
is unique to a patient hospital stay and stay_id
is unique to a patient ICU stay.
caregiver_id
caregiver_id
uniquely identifies a single caregiver who documented data in the ICU information system.
starttime
, endtime
starttime
and endtime
record the start and end time of an input/output event.
storetime
storetime
records the time at which an observation was manually input or manually validated by a member of the clinical staff.
itemid
Identifier for a single measurement type in the database. Each row associated with one itemid
which corresponds to an instantiation of the same measurement (e.g. norepinephrine).
amount
, amountuom
amount
and amountuom
list the amount of a drug or substance administered to the patient either between the starttime
and endtime
.
rate, rateuom
rate
and rateuom
list the rate at which the drug or substance was administered to the patient either between the starttime
and endtime
.
orderid, linkorderid
orderid
links multiple items contained in the same solution together. For example, when a solution of noradrenaline and normal saline is administered both noradrenaline and normal saline occur on distinct rows but will have the same orderid
.
linkorderid
links the same order across multiple instantiations: for example, if the rate of delivery for the solution with noradrenaline and normal saline is changed, two new rows which share the same new orderid
will be generated, but the linkorderid
will be the same.
ordercategoryname
, secondaryordercategoryname
, ordercomponenttypedescription
, ordercategorydescription
These columns provide higher level information about the order the medication/solution is a part of. Categories represent the type of administration, while the ordercomponenttypedescription
describes the role of the substance in the solution (i.e. main order parameter, additive, or mixed solution)
patientweight
The patient weight in kilograms.
totalamount
, totalamountuom
Intravenous administrations are usually given by hanging a bag of fluid at the bedside for continuous infusion over a certain period of time. These columns list the total amount of the fluid in the bag containing the solution.
isopenbag
Whether the order was from an open bag.
continueinnextdept
If the order ended on patient transfer, this field indicates if it continued into the next department (e.g. a floor).
statusdescription
statusdescription
states the ultimate status of the item, or more specifically, row. It is used to indicate why the delivery of the compound has ended. There are only six possible statuses:
- Changed - The current delivery has ended as some aspect of it has changed (most frequently, the rate has been changed)
- Paused - The current delivery has been paused
- FinishedRunning - The delivery of the item has finished (most frequently, the bag containing the compound is empty)
- Stopped - The delivery of the item been terminated by the caregiver
- Flushed - A line was flushed.
originalamount
Drugs are usually mixed within a solution and delivered continuously from the same bag. This column represents the amount of the drug contained in the bag at starttime
. For the first infusion of a new bag, originalamount
: totalamount
. Later on, if the rate is changed, then the amount of the drug in the bag will be lower (as some has been administered to the patient). As a result, originalamount
< totalamount
, and originalamount
will be the amount of drug leftover in the bag at that starttime
.
originalrate
This is the rate that was input by the care provider. Note that this may differ from rate
because of various reasons: originalrate
was the original planned rate, while the rate
column will be the true rate delivered. For example, if a a bag is about to run out and the care giver decides to push the rest of the fluid, then rate
> originalrate
.
However, these two columns are usually the same, but have minor non-clinically significant differences due to rounding error.
Feedback
Was this page helpful?
Glad to hear it! Please raise an issue here to tell us how we can improve.
Sorry to hear that. Please raise an issue here to tell us how we can improve.