# `Dicom.SR.Templates.KeyObjectSelection`
[🔗](https://github.com/Balneario-de-Cofrentes/dicom/blob/v0.9.1/lib/dicom/sr/templates/key_object_selection.ex#L1)

Builder for a TID 2000 Key Object Selection document.

KOS documents flag significant images within a study. The root container
holds an observer context, a textual description explaining the selection,
and one or more IMAGE references to the flagged instances.

Structure:

    CONTAINER: Key Object Selection (root concept = "Of Interest" or rejection code)
      ├── HAS CONCEPT MOD: Language (optional, defaults to en-US)
      ├── HAS OBS CONTEXT: Observer (person and/or device)
      ├── CONTAINS: Key Object Description (TEXT) — reason for selection
      └── CONTAINS: IMAGE references (1-n) — the flagged images

SOP Class UID: 1.2.840.10008.5.1.4.1.1.88.59 (Key Object Selection Document)

# `new`

```elixir
@spec new(keyword()) :: {:ok, Dicom.SR.Document.t()} | {:error, term()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*