dbdicom.Record.new_pibling

Record.new_pibling(**kwargs)

Create a new sibling of the parent record (pibling).

Parameters:

kwargs (optional) – Any valid DICOM (tag, value) pair can be assigned up front as properties of the new pibling.

Returns:

instance of the new parent

Return type:

Record

See also

new_patient() new_study() new_series()

Example

Use a series to create a new study directly. A use case is where image processing results derived from a series should be saved in a separate study under the same patient.

>>> fMRI = db.study(StudyDescription='fMRI', StudyDate='202305010')
>>> rstate = fMRI.new_series(SeriesDescription='Resting state')
>>> rstate_results = rstate.new_pibling(StudyDescription='fMRI resting state analysis', StudyDate='20230603')
>>> rstate.patient().print()
---------- PATIENT -------------
Patient New Patient
Study New Study [None]
    Series 001 [Resting state]
        Nr of instances: 0
Study fMRI resting state analysis [20230603]
--------------------------------