pynetdicom.pdu_items.ImplementationVersionNameSubItem

class pynetdicom.pdu_items.ImplementationVersionNameSubItem

An Implementation Version Name Sub-item.

The Implementation Version Name Sub-item allows communicating Application Entities to identify each other at Association establishment.

Notes

The Implementation Class UID Sub Item requires the following parameters:

• Item type (1, fixed, 0x55)

• Item length (1)

• Implementation version name (1)

Implementation Version Name

The Implementation Version Name shall be encoded as a string of 1 to 16 ISO 646:1990 (basic G0 set) characters.

Encoding

When encoded, an Implementation Version Name Sub-item has the following structure, taken from Tables D.3-3 and D.3-4 of the DICOM Standard (offsets shown with Python indexing). Items are always encoded using Big Endian.

Offset	Length	Description
0	1	Item type
1	1	Reserved
2	2	Item length
4	Variable	Implementation version name

References

• DICOM Standard, Part 7, Annex D.3.3.2

• DICOM Standard, Part 8, Section 9.3.1

__init__() → None

Initialise a new Implementation Version Name Item.

Methods

__init__()	Initialise a new Implementation Version Name Item.
decode(bytestream)	Decode bytestream and use the result to set the field values of the PDU item.
encode()	Return the encoded PDU as bytes.
from_primitive(primitive)	Set the item's values using an Implementation Identification primitive.
to_primitive()	Return an Implementation Identification primitive from the current Item.

Attributes

implementation_version_name	Return the item's Implementation Version Name field value.
item_length	Return the item's Item Length field value as int.
item_type	Return the item's Item Type field value as int.

from_primitive(primitive: ImplementationVersionNameNotification) → None

Set the item’s values using an Implementation Identification primitive.

Parameters:

primitive (pdu_primitives.ImplementationVersionNameNotification) – The primitive to use to set the Item’s field values.

property implementation_version_name: str | None

Return the item’s Implementation Version Name field value.

property item_length: int

Return the item’s Item Length field value as int.

to_primitive() → ImplementationVersionNameNotification

Return an Implementation Identification primitive from the current Item.

Returns:

The primitive representation of the current Item.

Return type:

pdu_primitives.ImplementationVersionNameNotification