Current Build

Переводит команда Health Samurai. Приглашаем поучаствовать в русификации стандарта FHIR: GitHub, Email.

Operation-observation-stats.json

Orders and Observations Work GroupMaturity Level: N/ABallot Status: InformativeCompartments: Device, Encounter, Patient, Practitioner, RelatedPerson

Raw JSON (каноническая форма + also see JSON Format Specification)

Operation Definition

{
  "resourceType" : "OperationDefinition",
  "id" : "Observation-stats",
  "text" : {
    "status" : "generated",
    "div" : "<div>!-- Snipped for Brevity --></div>"
  },
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 3
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use"
  }],
  "url" : "http://hl7.org/fhir/OperationDefinition/Observation-stats",
  "version" : "3.6.0",
  "name" : "Observation Statistics",
  "status" : "draft",
  "kind" : "operation",
  "date" : "2019-05-17T12:34:53+00:00",
  "publisher" : "HL7 (FHIR Project)",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    },
    {
      "system" : "email",
      "value" : "fhir@lists.hl7.org"
    }]
  }],
  "description" : "Операция \"Статистика\" выполняет ряд статистических вычислений на серии клинических измерений, таких как кровяное давление, хранящихся на сервере. Эта операция просчитывает ресурсы [Observation](observation.html), имеющие элементы valueQuantity с единицами измерения, указанными в UCUM. Ресурсы Observation со статусом 'entered-in-error' исключаются из вычислений. \r\rНабор ресурсов Observation определяется по 4 параметрам:\r\r*  субъект наблюдений, для которого генерируется статистика. (`subject`)\r* для каких наблюдений необходимо сгенерировать статистику (`code` и `system`, либо `coding`)\r* период времени, для которого надо посчитать статистику ('duration` или `period`)\r* виды статистического анализа, который необходимо провести (`statistic`)\r\rДоступные виды статистического анализа (см. [StatisticsCode](valueset-observation-statistics.html)):\r\r - **average** (\"Average\"): The [mean](https://en.wikipedia.org/wiki/Arithmetic_mean) of N measurements over the stated period.\r\n - **maximum** (\"Maximum\"): The [maximum](https://en.wikipedia.org/wiki/Maximal_element) value of N measurements over the stated period.\r\n - **minimum** (\"Minimum\"): The [minimum](https://en.wikipedia.org/wiki/Minimal_element) value of N measurements over the stated period.\r\n - **count** (\"Count\"): The [number] of valid measurements over the stated period that contributed to the other statistical outputs.\r\n - **total-count** (\"Total Count\"): The total [number] of valid measurements over the stated period, including observations that were ignored because they did not contain valid result values.\r\n - **median** (\"Median\"): The [median](https://en.wikipedia.org/wiki/Median) of N measurements over the stated period.\r\n - **std-dev** (\"Standard Deviation\"): The [standard deviation](https://en.wikipedia.org/wiki/Standard_deviation) of N measurements over the stated period.\r\n - **sum** (\"Sum\"): The [sum](https://en.wikipedia.org/wiki/Summation) of N measurements over the stated period.\r\n - **variance** (\"Variance\"): The [variance](https://en.wikipedia.org/wiki/Variance) of N measurements over the stated period.\r\n - **20-percent** (\"20th Percentile\"): The 20th [Percentile](https://en.wikipedia.org/wiki/Percentile) of N measurements over the stated period.\r\n - **80-percent** (\"80th Percentile\"): The 80th [Percentile](https://en.wikipedia.org/wiki/Percentile) of N measurements over the stated period.\r\n - **4-lower** (\"Lower Quartile\"): The lower [Quartile](https://en.wikipedia.org/wiki/Quartile) Boundary of N measurements over the stated period.\r\n - **4-upper** (\"Upper Quartile\"): The upper [Quartile](https://en.wikipedia.org/wiki/Quartile) Boundary of N measurements over the stated period.\r\n - **4-dev** (\"Quartile Deviation\"): The difference between the upper and lower [Quartiles](https://en.wikipedia.org/wiki/Quartile) is called the Interquartile range. (IQR = Q3-Q1) Quartile deviation or Semi-interquartile range is one-half the difference between the first and the third quartiles.\r\n - **5-1** (\"1st Quintile\"): The lowest of four values that divide the N measurements into a frequency distribution of five classes with each containing one fifth of the total population.\r\n - **5-2** (\"2nd Quintile\"): The second of four values that divide the N measurements into a frequency distribution of five classes with each containing one fifth of the total population.\r\n - **5-3** (\"3rd Quintile\"): The third of four values that divide the N measurements into a frequency distribution of five classes with each containing one fifth of the total population.\r\n - **5-4** (\"4th Quintile\"): The fourth of four values that divide the N measurements into a frequency distribution of five classes with each containing one fifth of the total population.\r\n - **skew** (\"Skew\"): Skewness is a measure of the asymmetry of the probability distribution of a real-valued random variable about its mean. The skewness value can be positive or negative, or even undefined.  Source: [Wikipedia](https://en.wikipedia.org/wiki/Skewness).\r\n - **kurtosis** (\"Kurtosis\"): Kurtosis  is a measure of the \"tailedness\" of the probability distribution of a real-valued random variable.   Source: [Wikipedia](https://en.wikipedia.org/wiki/Kurtosis).\r\n - **regression** (\"Regression\"): Linear regression is an approach for modeling two-dimensional sample points with one independent variable and one dependent variable (conventionally, the x and y coordinates in a Cartesian coordinate system) and finds a linear function (a non-vertical straight line) that, as accurately as possible, predicts the dependent variable values as a function of the independent variables. Source: [Wikipedia](https://en.wikipedia.org/wiki/Simple_linear_regression)  This Statistic code will return both a gradient and an intercept value.\r\n\r\rВ случае успеха операция возвращает ресурс Observation для каждого кода с результатами статистических вычислений в виде пар значений компонентов, где код компонента будет равен коду возвращаемой статистики. Ресурс Observation также будет содержать входные параметры `patient`,`code` и `duration`. В случае неуспеха вернется [OperationOutcome](operationoutcome.html) с текстом ошибки.\r\rКлиент может запросить вернуть также все ресурсы Observation, по которым строится статистика, используя параметр include. Если параметр include указан, то также можно указать и лимит; исходные ресурсы Observation подразделяются на усмотрение сервера, если их количество превышает лимит: count > limit. Эта функциональность была включена с целью поддержки графического представления",
  "code" : "stats",
  "comment" : "Если в Observation присутствуют [расширения-модификаторы](extensibility.html#modifierExtension), они должны быть учтены разработчиками. Расширение-модификтор может влиять на observation.value так, что его будет необходимо исключить из вычислений.\r\rЭту операцию не следует выполнять на тех наблюдениях, которые пользователь не уполномочен видеть. Предполагается, что сервер идентифицировал и обеспечил безопасность должным образом, и может либо связать контекст авторизации с отдельным пациентом, либо определитть, имеются ли в данном контексте права на указанного пациента, если такой есть. Если номинального пациента нет (например операция вызывается на системном уровне) и контекст не связан с отдельной записью пациента, тогда сервер должен вернуть ошибку. Указание отношения между контекстом, пользователем и записями пациенов выходит за рамки спецификации.",
  "resource" : ["Observation"],
  "system" : false,
  "type" : true,
  "instance" : false,
  "parameter" : [{
    "name" : "subject",
    "use" : "in",
    "min" : 1,
    "max" : "1",
    "documentation" : "Субъект релевантных ресурсов Observation, который имеет значение Observation.subject.reference. Например 'Patient/123'. Ссылка может быть абсолютным URL, однако северы выполняют операцию статистики только на своих ресурсах Observation",
    "type" : "uri"
  },
  {
    "name" : "code",
    "use" : "in",
    "min" : 0,
    "max" : "*",
    "documentation" : "Код(ы) тестов, над которыми выполняется операция статистики. Например LOINC code  = \r2339-0 (Glucose [Mass/​volume] in Blood) охватит все релевантные Observation с таким кодом в `Observation.code` and `Observation.component.code`. Для LOINC-кодов панелей, например 85354-9(Blood pressure panel with all children optional), операция статистики вернет статистику для каждой отдельной панели измерений. Это означает, что она включит и вычислит се значения, сгруппированные по коду для всех отдельных наблюдений, которые: 1) на которые имеют ссылки в `.related` для `.related.type` = 'has-member', и 2) являются компонентами в `Observation.component`.",
    "type" : "string"
  },
  {
    "name" : "system",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Система для кодов. Либо укажите вместо этого кодинг",
    "type" : "uri"
  },
  {
    "name" : "coding",
    "use" : "in",
    "min" : 0,
    "max" : "*",
    "documentation" : "Код теста, над которым выполняется статистика, в виде кодинга",
    "type" : "Coding"
  },
  {
    "name" : "duration",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Интересуемый период времени, заданный в часах. Например duration = \"1\" соответствует последнему часу - период времени от одного часа назад до текущего момента",
    "type" : "decimal"
  },
  {
    "name" : "period",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Период времени, для которого выполняются вычисления, если duration не указан",
    "type" : "Period"
  },
  {
    "name" : "statistic",
    "use" : "in",
    "min" : 1,
    "max" : "*",
    "documentation" : "average|max|min|count Статистические операции для выполнения соответствующих вычислений. Можно указывать несколько статистических операций. Эти коды определены [здесь](valueset-observation-statistics.html)",
    "type" : "code"
  },
  {
    "name" : "include",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Следует ли возвращать ресурсы, по которым считалась статистика",
    "type" : "boolean"
  },
  {
    "name" : "limit",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Если указан параметр include, дополнительно можно задать лимит количества возвращаемых ресурсов Observation. Если параметр include отсутствует или имеет значение \"false\", тогда параметр limit должен игнорироваться сервером",
    "type" : "positiveInt"
  },
  {
    "name" : "statistics",
    "use" : "out",
    "min" : 1,
    "max" : "*",
    "documentation" : "Ряд ресурсов Observation, один Observation для каждого кода, каждый содержит один компонент для каждой статистики. Observation.component.code содержит значение статистики, связан с Observation.code и не может быть интерпретирован отедльно от него. Observation будет также содержать элементы subject, effectivePeriod и code, отражающие входные параметры. Статус всегда будет `final`.",
    "type" : "Observation"
  },
  {
    "name" : "source",
    "use" : "out",
    "min" : 0,
    "max" : "*",
    "documentation" : "Исходные ресурсы Observation, по которым считается статистика",
    "type" : "Observation"
  }]
}

Примечание к использованию: мы очень стараемся приводить корректные и полезные примеры, но нормативно они не являются частью спецификации.