Unfortunately, filenames automatically created by acquisition software's are most of the time hard to manage, and convey no special meanings in a human-readable form. If the field is found in the field-dictionary and if the information is available in the file, its value is used to build a part of the destination filename. Otherwise, it is copied as is in the name, allowing the user to include strings too. It is also safe to use them in any cases, as dicom2 do not output anything but single-frame files. Therefore, DO NOT forget to use these fields in the pattern if you want to be sure that you will save the frames stored in a multiple-frame file.
Several aliases are available to specify the most usual combinations of fields.
Although the field dictionary may be hard to remember, all fields have been chosen to sound like their counterparts. Let's have a look at some examples, where mframe is a multi-frame file, which stores 5 frames. The contents of the resulting file is computed from the accumulated contents of all files, and vary depending on the mode . Be aware that most modes do not support samples per pixel greater than 1, as they have to compare or order pixels based on their value. Samples per pixel greater than 1 are not supported.