Working with Exams and Series

In Agora the typical data hierarchy is:

Patient → Exam (Study) → Series → Dataset → Datafile

Exams

exam = agora.get_exam(12)

exams = agora.get_exam_list()

exam = agora.get_exam_by_uid(project=2, uid='1.2.840.10008.5.1.4.1.1.4')

Creates a link — the exam remains in its original location and is also visible in the target folder:

folder     = agora.get_folder(10)
exam_item  = exam.link_to_folder(folder.id)

Remove the link (does not delete the exam):

exam_item.delete()

Locking prevents any further modifications to the exam:

exam.lock()
exam.unlock()

relations = exam.relations()

patients = agora.get_patients()
for p in patients:
    print(p.name)

patient = agora.get_patient(15)

series_list = exam.get_series()
for s in series_list:
    print(f'Series: {s.name}')

series = agora.get_series(76)

series = agora.get_series_by_uid(project=2, uid='1.2.840.10008.5.1.4.1.1.4.1')

datasets = series.get_datasets()

relations = series.relations()

datasets = exam.get_datasets()

Search for series by a free-text string:

results = agora.search_series('knee')
for s in results:
    print(s.name)