# `Dicom.DataElement`
[🔗](https://github.com/Balneario-de-Cofrentes/dicom/blob/v0.5.1/lib/dicom/data_element.ex#L1)

A single DICOM Data Element.

A data element is the fundamental unit of a DICOM data set, consisting of:
- **Tag**: `{group, element}` pair identifying the attribute
- **VR**: Value Representation (data type)
- **Value**: The actual data (binary, string, integer, etc.)
- **Length**: Byte length of the value field

Reference: DICOM PS3.5 Section 7.1.

# `t`

```elixir
@type t() :: %Dicom.DataElement{
  length: non_neg_integer() | :undefined,
  tag: tag(),
  value: binary() | term(),
  vr: Dicom.VR.t()
}
```

# `tag`

```elixir
@type tag() :: {non_neg_integer(), non_neg_integer()}
```

# `new`

```elixir
@spec new(tag(), Dicom.VR.t(), term()) :: t()
```

Creates a new data element.

---

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