# ovok_sdk.resources.measurement_services

Canonical page: https://docs.ovok.com/python-sdk/reference/resources/measurement_services

Per-type rules that turn a measurement into Observation details and show it as text.

## MeasurementField [#measurementfield]

```python
MeasurementField(
    key: str,
    code: str,
    display: str,
    unit: str,
    decimals: int,
    additional_codes: tuple[str, ...] = (),
)
```

One value of a measurement and how its Observation stores it.

**Attributes**

| Name | Type | Description |
| --- | --- | --- |
| `key` | `str` | The value's key on the measurement, in snake_case. |
| `code` | `str` | Code of the Observation that carries it. |
| `display` | `str` | Display name of that code. |
| `unit` | `str` | Unit the value is stored in. |
| `decimals` | `int` | Decimal places the value is rounded to. |
| `additional_codes` | `tuple[str, ...]` | Further codes of the same Observation. |

### concept() [#concept]

```python
concept() -> Resource
```

Return the Observation code as a CodeableConcept.

**Returns**

- `Resource`: The concept, primary code first.

## service_for() [#service_for]

```python
service_for(type_key: str) -> _FieldService
```

Return the rules for a measurement type.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `type_key` | `str` |  | The measurement type, such as `"blood-pressure"`. |

**Returns**

- `_FieldService`: The type's service.

**Raises**

- `OvokValidationError`: The SDK cannot save this type.

## ucum_quantity() [#ucum_quantity]

```python
ucum_quantity(value: int | float, unit: str) -> Resource
```

Return a quantity in `unit`, coded in UCUM when the unit has a UCUM code.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `int \| float` |  | The value. |
| `unit` | `str` |  | The display unit, such as `"mmHg"`; empty for none. |

**Returns**

- `Resource`: The FHIR Quantity.

## sampled_data() [#sampled_data]

```python
sampled_data(samples: list[Any], decimals: int) -> str
```

Return SampledData's space-separated values; a sample with no value is `E`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `samples` | `list[Any]` |  | The values. |
| `decimals` | `int` |  | Decimal places each value is rounded to. |

**Returns**

- `str`: The `data` string.

## read() [#read]

```python
read(mapping: Resource | None, snake: str) -> Any
```

Return a value by its snake_case key, or by the camelCase one.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `mapping` | `Resource \| None` |  | Where to look; `None` reads as empty. |
| `snake` | `str` |  | The snake_case key. |

**Returns**

- `Any`: The value, or `None`.

## camel() [#camel]

```python
camel(value: str) -> str
```

Return a snake_case key in camelCase.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `str` |  | The snake_case key. |

**Returns**

- `str`: The camelCase key.

## parse_date() [#parse_date]

```python
parse_date(value: Any) -> datetime | None
```

Return a datetime for a datetime, date or ISO string; naive values are UTC.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `Any` |  | The value. |

**Returns**

- `datetime | None`: The datetime, or `None` when the value is no date.

## iso() [#iso]

```python
iso(value: datetime | date | str) -> str
```

Return a time as UTC ISO 8601 with milliseconds; an unparseable string is kept.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `datetime \| date \| str` |  | The time. |

**Returns**

- `str`: The ISO string.

## number() [#number]

```python
number(value: Any) -> float | None
```

Return a finite number, or `None` for anything else.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `Any` |  | The value. |

**Returns**

- `float | None`: The number.
