20.1. Запуск программы из командной строки

Внимание! В операционных системах семейства macOS передача параметров командной строки не поддерживается.

Если на компьютере уже запущен DICOM-Просмотрщик, то параметры запуска из командной строки передаются запущенной программе. Второй экземпляр программы не запускается (см. раздел "Запуск нескольких экземпляров программы").

Запуск программы из командной строки позволяет задавать особые параметры текущего сеанса работы программы, изменить настройки и получить справочную информацию о параметрах командной строки. Синтаксис команды запуска:

[<путь_к_программе>]<имя_исполняемого_файла_программы> [ --help] | [--study-folder <path> [--open-series-images | --open-series-mpr | --open-series-volume | --open-series-
endoscopy [--series-uid <uid> | --series-index <index>]]] | [--pacs-aetitle <aetitle> [--patient-id <patientID>] [--study-uid <studyUID>] [--series-index <seriesIndex> | --series-uid <seriesUID>] [--open-series-images] ] | [--aet <aet>] | [--import-settings <path> [--use-imported-listener-aetitle | --aet <aet>] [--update-scu-aetitle]] | [--export-settings <path>]

--help: отображается справочная информация о параметрах командной строки, программа завершает работу.
--study-folder <path>: исследование (исследования), содержащееся в указанной папке, отображается на панели исследований. Применяются следующие параметры запуска:
- --patient-id <patientID>: в списке исследований ищутся исследования с соответствующим patientID. Параметр имеет более высокий приоритет, чем --study-uid
- --open-series-images: первая серия исследования открывается в окне просмотра плоских изображений
- --open-series-mpr: первая серия исследования открывается в окне мультипланарной реконструкции
- --open-series-volume: первая серия исследования открывается в окне объёмной реконструкции
- --open-series-endoscopy(PRO): первая серия исследования открывается в окне виртуальной эндоскопии
- С любым из этих параметров могут использоваться параметры:
  - --study-uid "<studyUID 1> \…\<studyUID N>": открывается первая серия из каждого выбранного исследования в списке с соответствующим studyUID
  - --series-uid "<seriesUID 1> \…\<seriesUID N>": открываются серии из списка с соответствующим seriesUID
  - --series-index "<seriesIndex 1> \…\<seriesIndex N>": открываются серии из списка с соответствующим seriesIndex. Нумерация параметра seriesIndex начинается с нуля и зависит от текущего типа сортировки серий в исследовании
--pacs-aetitle <aetitle>: делается попытка открыть список исследований с PACS-сервера, AE Title которого соответствует указанному AE Title. Для подключения используются параметры, указанные в настройках подключения к данному серверу (см. раздел 13.2). С этим параметром могут использоваться в разных сочетаниях следующие параметры:
- --patient-id <patientID>: в списке исследований ищутся исследования с соответствующим patientID. Параметр имеет более высокий приоритет, чем --study-uid
- --study-uid "<studyUID 1> \…\<studyUID N>": в списке исследований ищутся исследования с соответствующими studyUID
- --series-uid "<seriesUID 1> \…\<seriesUID N>": для выбранных исследований выбираются серии с соответствующим seriesUID
- --series-index "<seriesIndex 1> \…\<seriesIndex N>": для выбранных исследований выбираются серии с соответствующим seriesIndex. Нумерация параметра seriesIndex начинается с нуля и зависит от текущего типа сортировки серий в исследовании
- --open-series-images: выбранная серия открывается в окне просмотра плоских изображений. Если серия не выбрана, то открывается первая серия первого исследования

Список значений параметров передаётся одной строкой с разделителем в виде символа "\". Список значений параметров study-uid и series-uid составляются следующим образом: первому значению параметра из списка study-uid должно соответствовать первое значение параметра из списка series-uid, второму значению параметра из списка study-uid — второе значению параметра из списка series-uid и т.д. Если в одном из списков меньше значений параметров, чем в другом, то он дополняется пустыми значениями. Пустые значения можно передавать в начале и в середине списка.

Внимание! Список значений параметров не должен завершаться символом "\".

Аналогичным образом связаны списки параметров, передаваемые в study-uid и в series-index. Значения из списка series-uid имеют более высокий приоритет относительно значений из списка series-index. Если передаётся непустое значение параметра series-uid, то соответствующее значение параметра series-index игнорируется. Ниже приведён пример передачи списков параметров study-uid, series-uid и series-index в консольную команду:

C:\Users\user\DICOMViewerPro2.16.0\viewer.exe --study-folder D:\dicom_data --study-uid "\<studyUID 2>\<studyUID 3>\<studyUID 4>"--series-uid "<seriesUID 1>\\<seriesUID 3>"--series-index "<seriesIndex 1>\<seriesIndex 2>"

В операционных системах Linux необходимо экранировать символы "\" (указывать "\\" вместо "\").

В этом случае указанный выше пример будет иметь вид:

C:\Users\user\DICOMViewerPro2.16.0\viewer.exe --study-folder D:\dicom_data --study-uid "\\<studyUID 2>\\<studyUID 3>\\<studyUID 4>"--series-uid "<seriesUID 1>\\\\<seriesUID 3>"--series-index "<seriesIndex 1>\\<seriesIndex 2>"

В данном примере передаются 4 пары идентифицирующих серии значений параметров series-uid и/или series-index, которые соответствуют значениям параметров study-uid. Ниже рассмотрим каждую пару значений из примера.

study_uid = "", series_uid = <seriesUID 1>

study_uid = <studyUID 2>, series_index = <seriesIndex 2>

study_uid = <studyUID 3>, series_uid = <seriesUID 3>

study_uid = <studyUID 4>, series_index = 0

В случае передачи пустых значений series-uid и/или series-index (четвёртая пара значений из примера), выбирается первая серия из исследования (series_index = 0). При выборе из указанного исследования серии по значению параметра series-index учитывается текущий тип сортировки серий в исследовании.

Передача пустого значения study-uid обрабатываться следующим образом:

для команд открытия серий из каталога:
- игнорируется, если передано соответствующее непустое значение параметра series-uid. Поиск в списке найденных в каталоге исследований осуществляется по series-uid;
- используется study-uid первого найденного в списке исследования, если соответствующий series-uid не задан;
для команд открытия серий с PACS-сервера:
- всегда устанавливается study-uid первого исследования из найденных в списке.

Внимание! Если несколько серверов имеют одинаковые AE Title, то поиск данных выполняется на первом найденном сервере. Сортировка PACS-серверов происходит по полю "Название сервера".

Настройка подключения к PACS-серверам описана в разделе 13.2.

Длина значения AE Title не должна превышать 16 символов. Кириллические символы и знак "\" в значении AE Title не допускаются.

Следующие команды служат для изменения настроек. После выполнения любой из этих команд программа завершает работу, в случае успешного выполнения в командной строке появляется слово "Done" (выполнено).

--aet <aetitle>: AE Title DICOM-сервиса заменится на <aetitle>
--import-settings <ﬁle>: импортируются настройки из файла <ﬁle>.
- --use-imported-listener-aetitle: AE Title DICOM-сервиса заменится на указанный в файле настроек
  - если одновременно используется параметр --aet <aetitle>, AE Title DICOM-сервиса заменится на <aetitle>
- --update-scu-aetitle: Название клиента (SCU) для PACS-серверов AE Title DICOM-сервиса останется текущим
  - если одновременно используется параметр --aet <aetitle>, то Название клиента (SCU) для PACS-серверов заменится на <aetitle>
--export-settings <ﬁle>: настройки сохраняются в файл <ﬁle>.