- ``custom_anntypes``: The custom annotation types defined in the annotation file. A dictionary with {key:value} corresponding to {anntype:description}. eg. {'#': 'lost connection', 'C': 'reconnected'}

if field in ['recordname', 'annotator', 'fs', 'custom_anntypes']:

if len(annfieldtypes[field]>1):

raise TypeError('The '+field+' field must be one of the following types:', annfieldtypes)

else:

raise TypeError('The '+field+' field must be the following type:', annfieldtypes[0])

elif field == 'custom_anntypes':

# All key/values must be strings

for key in self.custom_anntypes.keys():

if type(key)!= str:

raise ValueError('All custom_anntypes keys must be strings')

if len(key)>1:

raise ValueError('All custom_anntypes keys must be single characters')

# Discourage (but not prevent) using existing codes

if key in annsyms.values():

print('It is discouraged to define the custom annotation code: '+key+' that already has an entry in the wfdb library.')

print('To see existing annotation codes and their meanings, call: showanncodes(). Continuing...')

for value in self.custom_anntypes.values():

if type(key)!= str:

raise ValueError('All custom_anntypes dictionary values must be strings')

# No pointless characters

acceptedstring = re.match('[\w -]+', value)

if not acceptedstring or acceptedstring.string != value:

raise ValueError('custom_anntypes dictionary values must only contain alphanumerics, spaces, underscores, and dashes')

print("All elements of the '"+field+"' field must be one of the following types:", annfieldtypes[field])

# Ensure all fields lie in standard WFDB annotation codes or custom codes

if set(self.anntype) - set(annsyms.values()).union() != set():

print("The 'anntype' field contains items not encoded in the WFDB library, or in this object's custom defined anntypes.")

print("To define custom codes, set the custom_anntypes field as a dictionary with format: {custom anntype character:description}")

# Calculate the fs bytes to write if present

fsbytes = []

# Calculate the custom_anntypes bytes to write if present

if self.custom_anntypes is not None:

cabytes = ca2bytes(self.custom_anntypes)

else:

cabytes = []

# Combine all bytes to write: fs (if any), custom annotations(if any), main content, file terminator

databytes = np.concatenate((fsbytes, cabytes, databytes, np.array([0,0]).astype('u1')))

def ca2bytes(custom_anntypes):

# The start wrapper: '0 NOTE length AUX ## annotation type definitions'

headbytes = [0,88,30,252,35,35,32,97,110,110,111,116,97,116,105,111,110,32,116

121,112,101,32,100,101,102,105,110,105,116,105,111,110,115]

# The end wrapper: '0 NOTE length AUX ## end of definitions' followed by SKIP -1, +1

tailbytes = [0,88,21,252,35,35,32,101,110,100,32,111,102,32,100,101,102,105,110,

105,116,105,111,110,115,0,0,236,255,255,255,255,1,0]

# Annotation codes range from 0-49.

freenumbers = list(set(range(50)) - set(annsyms.keys()))

if len(custom_anntypes) > len(freenumbers):

raise Exception('There can only be a maximum of '+len(freenumbers)+' custom annotation codes.')

# Allocate a number to each custom anntype.

# List sublists: [number, code, description]

writecontent = []

for i in range(len(custom_anntypes)):

writecontent.append([i,custom_anntypes.keys()[i],custom_anntypes.values()[i]])

custombytes = [customcode2bytes(triplet) for triplet in writecontent]

custombytes = [item for sublist in custombytes for item in sublist]

return np.array(headbytes+custombytes+tailbytes).astype('u1')

def customcode2bytes(c_triplet):

# Structure: 0, NOTE, len(aux), AUX, codenumber, space, codesymbol, space, description, (0 null if necessary)

# Remember, aux string includes 'number(s)<space><symbol><space><description>''

annbytes = [0, 88, len(c_triplet[2]) + 3 + len(str(c_triplet[0])), 252] + [ord(c) for c in str(c_triplet[0])] \

+ [32] + ord(c_triplet[1]) + [32] + [ord(c) for c in c_triplet[2]]

if len(annbytes) % 2:

annbytes.append(0)

return annbytes

41: 'RONT', # R-on-T premature ventricular contraction */

annfields = ['recordname', 'annotator', 'custom_anntypes', 'annsamp', 'anntype', 'num', 'subtype', 'chan', 'aux', 'fs']

raise TypeError("Channel "+str(ch)+" of field: '"+field+"' must be one of the following types:", allowedtypes)

raise TypeError("Channel "+str(ch)+" of field: '"+field+"' must be a 'None', or one of the following types:", allowedtypes)

raise TypeError("Field: '"+field+"' must be one of the following types:", allowedtypes)