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.

implementation_version_name

The Implementation Version Name field value, 1 to 16 characters.

Type:bytes or None
item_length

The number of bytes from the first byte following the Item Length field to the last byte of the Item.

Type:int
item_type

The Item Type field value (0x55).

Type:int

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 [1] (offsets shown with Python indexing). Items are always encoded using Big Endian [2].

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

References

[1]DICOM Standard, Part 7, Annex D.3.3.2
[2]DICOM Standard, Part 8, Section 9.3.1
__init__()

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 an int.
item_type Return the item’s Item Type field value as an int.
decode(bytestream)

Decode bytestream and use the result to set the field values of the PDU item.

Parameters:bytestream (bytes) – The PDU data to be decoded.
encode()

Return the encoded PDU as bytes.

Returns:The encoded PDU.
Return type:bytes
from_primitive(primitive)

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.
implementation_version_name

Return the item’s Implementation Version Name field value.

item_length

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

item_type

Return the item’s Item Type field value as an int.

to_primitive()

Return an Implementation Identification primitive from the current Item.

Returns:The primitive representation of the current Item.
Return type:pdu_primitives.ImplementationVersionNameNotification