pydicom.valuerep.PersonName

class pydicom.valuerep.PersonName(val)

Human-friendly class to hold the value of elements with VR of ‘PN’.

The value is parsed into the following properties:

• single-byte, ideographic, and phonetic components (DICOM Standard, Part 5, Section 6.2.1)
• family_name, given_name, middle_name, name_prefix, name_suffix

__init__(val)

Initialize the PN properties

Methods

__init__(val)	Initialize the PN properties
capitalize()	Return a copy of B with only its first character capitalized (ASCII) and the rest lower-cased.
center	Return a centered string of length width.
count(sub[, start[, end]])	Return the number of non-overlapping occurrences of subsection sub in bytes B[start:end].
decode	Decode the bytes using the codec registered for encoding.
encode(*args)	Dummy method to mimic py2 str behavior in py3 bytes subclass
endswith(suffix[, start[, end]])	Return True if B ends with the specified suffix, False otherwise.
expandtabs	Return a copy where all tab characters are expanded using spaces.
family_comma_given()	Return name as ‘Family-name, Given-name’
find(sub[, start[, end]])	Return the lowest index in B where subsection sub is found, such that sub is contained within B[start,end].
formatted(format_str)	Return a formatted string according to the format pattern
fromhex	Create a bytes object from a string of hexadecimal numbers.
hex	Create a str of hexadecimal numbers from a bytes object.
index(sub[, start[, end]])	Return the lowest index in B where subsection sub is found, such that sub is contained within B[start,end].
isalnum()	Return True if all characters in B are alphanumeric and there is at least one character in B, False otherwise.
isalpha()	Return True if all characters in B are alphabetic and there is at least one character in B, False otherwise.
isascii()	Return True if B is empty or all characters in B are ASCII, False otherwise.
isdigit()	Return True if all characters in B are digits and there is at least one character in B, False otherwise.
islower()	Return True if all cased characters in B are lowercase and there is at least one cased character in B, False otherwise.
isspace()	Return True if all characters in B are whitespace and there is at least one character in B, False otherwise.
istitle()	Return True if B is a titlecased string and there is at least one character in B, i.e.
isupper()	Return True if all cased characters in B are uppercase and there is at least one cased character in B, False otherwise.
join	Concatenate any number of bytes objects.
ljust	Return a left-justified string of length width.
lower()	Return a copy of B with all ASCII characters converted to lowercase.
lstrip	Strip leading bytes contained in the argument.
maketrans	Return a translation table useable for the bytes or bytearray translate method.
parse()	Break down the components and name parts
partition	Partition the bytes into three parts using the given separator.
replace	Return a copy with all occurrences of substring old replaced by new.
rfind(sub[, start[, end]])	Return the highest index in B where subsection sub is found, such that sub is contained within B[start,end].
rindex(sub[, start[, end]])	Return the highest index in B where subsection sub is found, such that sub is contained within B[start,end].
rjust	Return a right-justified string of length width.
rpartition	Partition the bytes into three parts using the given separator.
rsplit	Return a list of the sections in the bytes, using sep as the delimiter.
rstrip	Strip trailing bytes contained in the argument.
split	Return a list of the sections in the bytes, using sep as the delimiter.
splitlines	Return a list of the lines in the bytes, breaking at line boundaries.
startswith(prefix[, start[, end]])	Return True if B starts with the specified prefix, False otherwise.
strip	Strip leading and trailing bytes contained in the argument.
swapcase()	Return a copy of B with uppercase ASCII characters converted to lowercase ASCII and vice versa.
title()	Return a titlecased version of B, i.e.
translate	Return a copy with each character mapped by the given translation table.
upper()	Return a copy of B with all ASCII characters converted to uppercase.
zfill	Pad a numeric string with zeros on the left, to fill a field of the given width.

encode(*args)

Dummy method to mimic py2 str behavior in py3 bytes subclass

family_comma_given()

Return name as ‘Family-name, Given-name’