Запуск программы с помощью командной строки и URL-протокола

Программа имеет возможность быстрого запуска в различных режимах работы через командную строку и URL-протокол

Запуск программы с использованием аргументов командной строки

• mode указывает дальнейшую работу программы после запуска. Доступны следующие режимы:
  • show - по-умолчанию. Загрузить и вывести исследование на экран, без открытия дополнительных окон поверх
    Для скачивания нужно указать studyUid выбранного исследования (аргумент uid) или фильтр поиска (аргумент filter), а также PACS с которого данное исследование нужно загрузить(аргумент pacs или явный набор параметров сервера)
  • query - найти исследования и показать их в окне "Импорт из PACS". Поиск осуществляется с помощью аргументов uid и filter на заданном PACS (аргумент pacs или явный набор параметров сервера)
  • create - запустить создание нового исследования с заранее заданными параметрами (аргумент filter)
  • worklist - найти задания и показать их в окне "Список заданий". Поиск осуществляется с помощью аргумента filter на заданном PACS (аргумент pacs или явный набор параметров сервера)
  • export - запустить программу в режиме скачивания с последующей записью исследования на диск
    Поиск осуществляется с помощью аргументов uid и filter на заданном PACS (аргумент pacs или явный набор параметров сервера)
  • archive - после запуска программы открыть окно "Архив"
• pacs указывает AETitle PACS, с которого планируется загрузка исследования
  Данный PACS должен быть сконфигурирован
• uid задает значение Study Instance UID (тег 0020, 000d) исследования, которое нужно скачать с PACS
  Может быть указано несколько аргументов uid для загрузки нескольких исследований.
• ip указывает ip-адрес PACS, с которым планируется взаимодействие
  
• port указывает порт PACS, с которым планируется взаимодействие
  
• aet указывает AETitle PACS, с которым планируется взаимодействие
  
• aec указывает AETitle программы, с которым она будет обращаться к PACS
  
• url указывает url DICOMweb сервиса PACS, с которым планируется взаимодействие
  
• urlWado указывает url WADO-сервиса DICOMweb PACS, с которым планируется взаимодействие
  
• filter задает фильтр, по которому происходит поиск исследований на сервере или предзаполнение форм в диалоговых окнах
  Задается как набор пар ТAG=VALUE, разделенных символом &. TAG - группа и код DICOM-тега, VALUE - значение тега
  Итоговая строка обрабатывается urlEndode (процентная кодировка) и помещается в кавычки
  Например, фильтр на исследования модальности CR и CT пациента с именем IVANOV будет задан как следующим образом:
  "00100010%3DIVANOV%2600080061%3DCR,CT"
  Общий вид:
  "<TAG>%3D<VALUE>%26<TAG>%3D<VALUE>"
Если в результате применения фильтра в режимах export и show (т.е. со скачиванием) будет найдено более 4 исследований в PACS, откроется окно "Импорт из PACS" для выбора нужных исследований
В ином случае (меньше 4 исследований или четыре), все они будут загружены в ленту и первое из них будет выведено на экран

• find необязательно. Уточняет метод, с помощью которого будет получена информация об исследовании
  Доступны два метода: cfind и qido-rs для DICOM и DICOMweb серверов соответственно.
• get необязательно. Уточняет метод, с помощью которого будет произведено скачивание снимков
  Доступны по два метода для DICOM и DICOMweb серверов: cget, cmove и wado-rs, wado-uri, соответственно.

Примеры использования аргументов командной строки

• vdviewer -mode show -uid 123.456.789 -pacs VIDAR
  Запуск программы для загрузки и показа исследования со Study Instance Uid 123.456.789 с помощью методов по умолчанию
  В качестве сервера будет выбран PACS с AETitle VIDAR, по окончании загрузки исследование будет выведено в ленту и на экран
  
• vdviewer -pacs DCM4CHEE -filter "00080050%3D706135" -mode show
  Запуск программы для загрузки и показа исследований по фильтру поиска Accession Number (тег 0008, 0050) = 706135 с помощью методов по умолчанию
  В качестве сервера выбран PACS с AETitle DCM4CHEE, по окончании загрузки исследование будет выведено в ленту и на экран
  Поиск с отбором по тегу Accession Number(0008,0050) полезен при интеграции с внешними МИС, когда значение этого тега соответствует "номеру направления на исследование" в МИС
• vdviewer.exe -url http://192.168.128.1/dicom/dicomweb/ -urlWado http://192.168.128.1/wado/ -mode show -filter "00100010%3DIVANOVA*"
  Запуск программы для загрузки и показа исследований по фильтру поиска Patient Name (тег 0010, 0010) = IVANOVA* с помощью методов по умолчанию
  В качестве сервера вручную задан PACS с адресом DICOMweb http://192.168.128.1/dicom/dicomweb/ и адресом WADO-сервиса http://192.168.128.1/wado/
  Символ * в конце имени пациента указывает на поиск по началу: т.е. найдутся пациенты с Patient Name IVANOVA I.I. и IVANOVA E.V
  Если по фильтру будет найдено более 4 исследований, программа покажет все найденные исследования в окне "Импорт исследований из PACS". Скачать их можно вручную по кнопке "Импорт"
• vdviewer -pacs DCM4CHEE -get cmove -mode show -uid 123.456.789 -uid 987.654.321 -uid 1.234.567.000
  Запуск программы для загрузки и показа исследований со Study Instance Uid 123.456.789, 987.654.321, 1.234.567.000 с помощью метода поиска по умолчанию и метода загрузки C-GET
  В качестве сервера выбран PACS с AETitle VIDAR, по окончании загрузки исследования будут выведены в ленту, последнее исследование (1.234.567.000) будет выведено на экран
  Обратите внимание, что в этом случае используется заранее созданная конфигурация PACS с типом Classic DICOM, которая по умолчанию выполняет поиск и загрузку с помощью методов C-FIND и C-GET
  С помощью аргумента get мы уточняем, что хотим использовать метод загрузки C-MOVE
• vdviewer -uid 123.456.789
  Запуск программы для загрузки и показа исследования со Study Instance Uid 123.456.789 с помощью методов по умолчанию
  В качестве сервера будет выбран первый PACS в списке, по окончании загрузки исследование будет выведено в ленту и на экран
  В качестве методов по умолчанию будут выбраны:
  • Если тип конфигурации DICOMweb - QIDO-RS и WADO-RS
  • Если тип конфигурации Classic DICOM - CFIND и CGET
• vdviewer.exe -mode export -pacs VIDAR -uid 123.456.789
  Запуск программы для загрузки и записи на диск (экспорта) исследования со Study Instance Uid 123.456.789. Методы поиска и скачивания определяются типом конфигурации сервера
  В качестве сервера выбран PACS с AETitle VIDAR, по окончании загрузки откроется окно "Запись"
• vdviewer.exe -mode export -get wado-uri -uid 123.456.789 -pacs VIDAR
  Запуск программы для загрузки и записи на диск (экспорта) исследования со Study Instance Uid 123.456.789 с помощью метода поиска по умолчанию и метода загрузки WADO-URI
  В качестве сервера выбран PACS с AETitle VIDAR, по окончании загрузки откроется окно "Запись"
  Обратите внимание, что в этом случае используется заранее созданная конфигурация PACS с типом DICOMweb, которая по умолчанию выполняет поиск и загрузку с помощью методов QIDO-RS и WADO-RS
  С помощью аргумента get мы уточняем, что хотим использовать метод загрузки WADO-URI
• vdviewer -ip 192.168.128.1 -port 104 -aet VIDAR -aec IMPORT -mode export -filter "00100020%3DIB345-24"
  Запуск программы для загрузки и записи на диск (экспорта) исследований по фильтру поиска ID Patient(тег 0010, 0020) = IB345-24 с помощью методов по умолчанию
  В качестве сервера вручную задан PACS с адресом 192.168.128.1:104 и AETitle VIDAR, загрузка будет производиться от имени IMPORT. По окончании загрузки откроется окно "Запись"
  Поиск с отбором по тегу Patient ID(00100020) может быть полезен для просмотра всех исследований пациента, если в это поле вносится его "номер": номер амбулаторной карты, СНИЛС, номер истории болезни
• vdviewer -mode query -pacs ORTHANC -filter "00080020%3D20240927-20240927"
  Запуск программы для поиска исследований в PACS по фильтру поиска Study Date (Дата проведения исследования, тег 0008, 0020) = 27.09.2024-27.09.2024, т.е. за один день
  В качестве сервера выбран PACS с AETitle ORTHANC
  По окончании поиска будет показано окно "Импорт исследований из PACS" с найденными исследованиями
  
• vdviewer.exe -mode query -pacs ORTHANC -filter "00080020%3D20240926-20240927%2600080061%3DCR,CT"
  Запуск программы для поиска исследований в PACS по фильтру поиска Study Date (Дата проведения исследования, тег 0008, 0020) = 26.09.2024-27.09.2024, т.е. за два дня и с модальностями CR, CT (Modalities in Study, тег 0008, 0061)
  В качестве сервера выбран PACS с AETitle ORTHANC
  По окончании поиска будет показано окно "Импорт исследований из PACS" с найденными исследованиями
  
• vdviewer.exe -mode create -filter "00100010%3DIVANOVA I.I.%2600100020%3DIB345-24%2600080050%3D706135%2600080060%3DCT"
  Запуск программы и открытие окна создания нового исследования с заранее введенными данными из фильтра, а именно:
  
  • Имя (тег 0010, 0010) = IVANOVA I.I.
  • ID (тег 0010, 0020) = IB345-24
  • Accession Number (тег 0008, 0050) = 706135
  • Модальность (тег 0008, 0060) = CT
  Также доступны следующие теги для заполнения окна создания нового исследования:
  • Производитель - тег 0008, 0070
  • Пол - тег 0010, 0040. Например, M, F, O
  • Название учреждения - тег 0008, 0080
  • Описание - тег 0008, 1030
  • Дата исследования - тег 0008, 0020. Например, 20241129
  • Время исследования - тег 0008, 0030. Например, 13:00
  • Дата рождения - тег 0010, 0030. Например, 19900830
  • Вес - тег 0010, 1030
  • Рост - тег 0010, 1020
  • Адрес учреждения - тег 0008, 0081
  • Лечащий врач - тег 0008, 0090
  • Направивший врач - тег 0008, 1050
  • Лаборант - тег 0008, 1070
• vdviewer.exe -mode worklist -filter "00100010%3DIVANOVA I.I" -pacs VIDAR
  Запуск программы с открытием окна "Список заданий" (Modality Worklist) с последующим поиском задания по фильтру поиска Patient Name (тег 0010, 0010) = "IVANOVA I.I."
  Поиск осуществляется по PACS с AETitle VIDAR
  Также доступны следующие теги для фильтрации:
  • ID - тег 0010, 0020
  • Accession Number - тег 0008, 0050
  • Модальности в исследовании - тег 0008, 0061. Например, "CR,CT"
  • Дата исследования - тег 0008, 0020. Требуется промежуток, например, 20241125-20241129
• vdviewer -mode archive
  Запуск программы с последующим открытием окна локального архива

Запуск программы через URL-протокол

В качестве аргументов выступают те же аргументы, что и при запуске из командной строки, значения подчиняются тем же правилам, что и при запуске из командной строки

В качестве примеров приводятся возможные варианты запуска:

• vdviewer3://api?mode=show&uid=123.456.789&pacs=VIDAR
• vdviewer3://api?pacs=DCM4CHEE&filter="00080050%3D706135"&mode=show
• vdviewer3://api?url=http://192.168.128.1/dicom/dicomweb/&urlWado=http://192.168.128.1/wado/&mode=show&filter="00100010%3DIVANOVA*"
• vdviewer3://api?pacs=DCM4CHEE&get=cmove&mode=show&uid=123.456.789&uid=987.654.321&uid=1.234.567.000
• vdviewer3://api?uid=123.456.789
• vdviewer3://api?mode=export&pacs=VIDAR&uid=123.456.789
• vdviewer3://api?mode=export&get=wado-uri&uid=123.456.789&pacs=VIDAR
• vdviewer3://api?ip=192.168.128.1&port=104&aet=VIDAR&aec=IMPORT&mode=export&filter="00100020%3DIB345-24"
• vdviewer3://api?mode=query&pacs=ORTHANC&filter="00080020%3D20240927-20240927"
• vdviewer3://api?mode=query&pacs=ORTHANC&filter="00080020%3D20240926-20240927%2600080061%3DCR,CT"
• vdviewer3://api?mode=create&filter="00100010%3DIVANOVA I.I.%2600100020%3DIB345-24%2600080050%3D706135%2600080060%3DCT"
• vdviewer3://api?mode=worklist&filter="00100010%3DIVANOVA I.I"&pacs=VIDAR
• vdviewer3://api?mode=archive

Запуск в режиме проверки целостности DICOM-файлов

• (0) Success
• (1) ErrorOpenTaskFile
• (2) ErrorFileNotFound
• (3) ErrorNoMetaInformation
• (4) ErrorUnsupportedSopClass
• (5) ErrorParsing
• (6) PartiallyDamaged: мультифрейм, среди битых есть целые снимки
• (7) CompletelyDamaged: все снимки битые

Проверка одного файла

Проверка всех файлов в папке

Проверка всех файлов согласно списку в указанном входном файле

Протокол обмена с Vidar

Импорт исследований из Vidar

Запись исследований из Vidar

Создание нового исследования с последующей передачей в Vidar

Загрузка DICOM из файла, папки, zip-архива

• Настройка взаимодействия с PACS
• Настройка взаимодействия с Видар 3
• Создание нового DICOM-исследования из изображений/фильмов, добавление изображений/фильмов к исследованию
• Список заданий (Modality Worklist)