dcmsend - Интернет в облаке

ПРОГРАММА:

ИМЯ

dcmsend - Простое хранилище DICOM SCU (отправитель)

СИНТАКСИС

dcmsend [параметры] одноранговый порт dcmfile-in ...

ОПИСАНИЕ

Команда dcmsend приложение реализует пользователя класса обслуживания (SCU) для службы хранилища
Класс. В отличие от известных магазины утилита, dcmsend имеет меньше вариантов и есть,
следовательно, проще в использовании - это также объясняет термин «простой» в названии. Главный
цель этого приложения - отправить целую кучу файлов DICOM в службу хранения.
Провайдер классов (SCP). dcmsend поддерживает обе множественные ассоциации (одну за другой)
и распаковка экземпляров DICOM SOP, если это необходимо для их передачи.

ПАРАМЕТРЫ

одноранговое имя узла DICOM однорангового узла

порт tcp / ip номер порта однорангового узла

dcmfile-in DICOM-файл или каталог для передачи

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Генеральная кредита
-ч --помощь
распечатайте этот текст справки и выйдите

--версия
распечатать информацию о версии и выйти

--list-декодеры
перечислить синтаксисы передачи декодеров и выйти

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

-q --тихий
тихий режим, печать без предупреждений и ошибок

-v --подробный
подробный режим, детали обработки печати

-d --отладка
режим отладки, печать отладочной информации

-ll --log-level [l] evel: строковая константа
(фатальный, ошибка, предупреждение, информация, отладка, трассировка)
использовать уровень l для регистратора

-lc --log-config [f] имя_файла: строка
используйте файл конфигурации f для регистратора

+ v --verbose-pc
показать контексты презентации в подробном режиме

вход кредита
формат входного файла:

+ f - читать файл
прочитать формат файла или набор данных

+ fo - только чтение-файл
только чтение формата файла (по умолчанию)

-f --read-набор данных
читать набор данных без метаинформации файла

входные файлы:

+ rd --read-from-dicomdir
читать информацию о входных файлах из DICOMDIR

+ sd --scan-каталоги
сканировать каталоги на наличие входных файлов (dcmfile-in)

+ sp --scan-pattern [p] attern: string (только с --scan-directoryies)
шаблон для сопоставления имени файла (подстановочные знаки)

# возможно не во всех системах

-r --нет-рекурсии
не рекурсивно использовать каталоги (по умолчанию)

+ r - повторение
рекурсивно в указанных каталогах

обработка кредита
преобразование синтаксиса передачи:

-dn --распаковывать-никогда
никогда не распаковывать сжатые наборы данных

+ dls - декомпрессия без потерь
только распаковывать сжатие без потерь (по умолчанию)

+ dly - декомпрессия с потерями
распаковать сжатие как с потерями, так и без потерь

спущенный уровень сжатия:

+ cl --compression-level [l] уровень: целое число (по умолчанию: 6)
0 = без сжатия, 1 = самое быстрое, 9 = наилучшее сжатие

другие варианты обработки:

-nh --без остановки
не останавливаться на первом неверном входном файле
или если обнаружился неудачный магазин

-nip --no-незаконное-предложение
не предлагайте контекст презентации, который
не содержать синтаксис передачи по умолчанию (при необходимости)

-nuc --no-uid-проверяет
не проверять значения UID входных файлов

сеть кредита
заголовки сущностей приложения:

-aet --aetitle [a] etitle: строка
установить мой вызывающий заголовок AE (по умолчанию: DCMSEND)

-aec --call [a] etitle: строка
установить названный AE-заголовок однорангового узла (по умолчанию: ANY-SCP)

обработка ассоциации:

+ ma - мульти-ассоциации
использовать несколько ассоциаций (одну за другой)
при необходимости передать экземпляры (по умолчанию)

-ma - single-association
всегда используйте одну ассоциацию

другие параметры сети:

-to --timeout [s] econds: integer (по умолчанию: неограниченно)
тайм-аут для запросов на подключение

-ta --acse-timeout [s] econds: integer (по умолчанию: 30)
таймаут для сообщений ACSE

-td --dimse-timeout [s] econds: integer (по умолчанию: без ограничений)
таймаут для сообщений DIMSE

-pdu --max-pdu [n] количество байтов: целое число (4096..131072)
установить максимальный получаемый pdu равным n байтам (по умолчанию: 16384)

--max-send-pdu [n] количество байтов: целое (4096..131072)
ограничить максимальную отправку pdu до n байтов

выходной кредита
Генеральная:

+ crf --create-report-file [f] имя-файла: строка
создать подробный отчет о переводе
(в случае успеха) и запишите его в текстовый файл f

ПРИМЕЧАНИЯ

типичный Применение
Типичный вариант использования dcmsend заключается в отправке произвольных экземпляров SOP, которые хранятся как DICOM
файлы в хранилище SCP. Следующая команда делает именно это:

dcmsend --verbose * .dcm

Если файлы DICOM хранятся в иерархии каталогов ниже каталога «ИЗОБРАЖЕНИЯ»,
можно использовать следующую команду:

dcmsend -v --scan-directoryies --recurse ИЗОБРАЖЕНИЯ

Также можно указать несколько каталогов и объединить вышеупомянутые
подходы (с использованием имен файлов и каталогов):

dcmsend -v + sd + r ИЗОБРАЖЕНИЯ_1 ИЗОБРАЖЕНИЯ_2 test.img * .dcm

Если на экземпляры SOP ссылаются из файла DICOMDIR, опция --read-from-dicomdir (или
+ rd) можно использовать для отправки всех файлов DICOM, на которые есть ссылки, без их загрузки для
переговоры об ассоциации:

dcmsend -v --read-from-dicomdir DICOMDIR

И снова все вышеперечисленные подходы можно комбинировать так:

dcmsend -v + sd + r + rd ИЗОБРАЖЕНИЯ_1 ИЗОБРАЖЕНИЯ_2 test.img DICOMDIR * .dcm

Вариант по умолчанию - только чтение-файл гарантирует, что только файлы DICOM (т. е. файлы с
мета-заголовок и магическое слово 'DICM' после преамбулы) обрабатываются. Обычно, если
обрабатывая целую кучу файлов, также рекомендуется не останавливаться на первом недопустимом
входной файл или если было обнаружено неудачное хранилище. Это можно сделать, используя
вариант - без остановки. Обратите внимание, однако, что «неудачный магазин» не означает, что
Состояние DIMSE ответа C-STORE указывает на ошибку. Это означает, что запрос C-STORE
не удалось отправить в хранилище SCP.

Если требуется более 128 контекстов представления, это максимально допустимое число
согласно стандарту DICOM, новая ассоциация запускается после того, как предыдущая
завершено. В случаях, когда такое поведение нежелательно, его можно отключить с помощью опции
--одноассоциация. Кроме того, доступны ли только наборы сжатых данных без потерь
распакованный (при необходимости), который используется по умолчанию, или наборы данных, сжатые с потерями, могут быть
указано с использованием --decompress-xxx настройки.

Чтобы получить как обзорную, так и подробную информацию о передаче DICOM SOP
экземпляры, вариант --создать-файл-отчета можно использовать для создания соответствующего текстового файла.
Однако этот файл создается только в качестве последнего шага, если приложение не завершилось.
раньше (с ошибкой).

Сканирование Справочники
Добавление каталогов в качестве параметра в командную строку имеет смысл, только если опция - сканировать-
каталоги также дается. Если нужно выбрать файлы в предоставленных каталогах
в соответствии с определенным шаблоном имени (например, с использованием подстановочного знака), опция --скан-шаблон
должен использоваться. Обратите внимание, что этот шаблон файла применяется только к файлам в
просканированные каталоги, и, если какие-либо другие шаблоны указаны в командной строке за пределами
--скан-шаблон вариант (например, чтобы выбрать другие файлы), они не применяются к
указанные каталоги.

Таким образом, третий из приведенных выше примеров будет повторяться по каталогам IMAGES_1 и IMAGES_2.
и передавать файлы, содержащиеся в этих двух папках и во всех их подпапках (из-за
к варианту +r). Дополнительно, dcmsend перенесет test.img и все файлы с расширением
'dcm' из текущей рабочей папки. Обратите внимание, что предоставление имен каталогов без
возможность включения + SD не имеет смысла.

DICOM Соответствие
В основном, dcmsend приложение поддерживает все классы SOP хранилища как SCU, включая
частные. По умолчанию приложение проверяет UID класса SOP файла DICOM в
чтобы убедиться, что отправляются только действительные экземпляры SOP. С опцией --no-uid-check
эту проверку можно отключить.

Команда dcmsend приложение также поддерживает все синтаксисы передачи, определенные в DICOM.
стандарт. Синтаксисы частной передачи можно использовать только в том случае, если проверка UID отключена с помощью
вариант --no-uid-check. Обратите внимание, однако, что только ограниченное количество переводов
поддерживаются синтаксисы для преобразования их в синтаксис передачи по умолчанию (неявный VR
Little Endian). С опцией --list-декодеры синтаксисы передачи, поддерживаемые изначально или
перечислены декодеры. Результат обычно выглядит следующим образом:

Синтаксисы передачи изначально поддерживаются:
- Неявный порядок байтов с прямым порядком байтов
- Прямой прямой порядок байтов
- Явный порядок байтов с порядком байтов

Синтаксисы передачи, поддерживаемые декодерами:
- Отклоненный явный VR Little Endian
- Базовый формат JPEG
- JPEG расширенный, процесс 2 + 4
- Спектральный выбор JPEG, неиерархический, процесс 6 + 8
- Полная прогрессия JPEG, неиерархическая, процесс 10 + 12
- JPEG без потерь, неиерархический, процесс 14
- JPEG без потерь, неиерархический, прогноз 1-го порядка
- JPEG-LS без потерь
- JPEG-LS с потерями (почти без потерь)
- RLE без потерь

С dcmsend старается быть максимально простым для пользователя, по умолчанию презентация
SCP могут быть предложены контексты, которые, строго говоря, являются «незаконными». Это
потому что, согласно стандарту DICOM, SCU всегда должен предлагать значение по умолчанию
синтаксис передачи, по крайней мере, в одном контексте представления, связанный с каждым абстрактным синтаксисом
(т.е. класс СОП). Это требование отменяется, если SCU имеет доступ только к SOP.
экземпляр в сжатом виде с потерями. С опцией --no-незаконное-предложение строгий DICOM-
согласованное поведение может быть навязано, т. е. никакой потенциально недопустимый контекст представления не будет
предложено, но соответствующий экземпляр СОП будет отклонен (при необходимости).

Однако обратите внимание, что синтаксис передачи по умолчанию для «Сжатия JPEG без потерь»,
«Сжатие JPEG с потерями» и т. Д. Не всегда предлагаются, как того требует DICOM.
стандарт. То же ограничение применяется и к другим схемам сжатия. См. DICOM PS 3.5
раздел 10 для подробностей.

ВЕДЕНИЕ ЖУРНАЛА

Уровень вывода журнала различных инструментов командной строки и базовых библиотек может
указывается пользователем. По умолчанию в стандарт записываются только ошибки и предупреждения.
поток ошибок. Использование опции --подробный также информационные сообщения, такие как детали обработки
сообщаются. Вариант --отлаживать можно использовать для получения более подробной информации о внутренней деятельности,
например, для отладки. Другие уровни ведения журнала можно выбрать с помощью опции --бревно-
уровень. В --тихий сообщается только о фатальных ошибках. В таких случаях очень серьезных ошибок
приложение обычно закрывается. Для получения дополнительной информации о различных уровнях ведения журнала,
см. документацию модуля oflog.

В случае, если вывод журнала должен быть записан в файл (необязательно с ротацией файла журнала),
в системный журнал (Unix) или в журнал событий (Windows). --log-config может быть использован. Этот
файл конфигурации также позволяет направлять только определенные сообщения на конкретный вывод
поток и для фильтрации определенных сообщений на основе модуля или приложения, в котором они
генерируются. Пример файла конфигурации представлен в /logger.cfg.

КОМАНДА ЛИНИЯ

Все инструменты командной строки используют следующие обозначения параметров: квадратные скобки заключают
необязательные значения (0-1), три точки в конце указывают, что разрешено несколько значений
(1-n), комбинация обоих означает от 0 до n значений.

Параметры командной строки отличаются от параметров ведущим знаком "+" или "-",
соответственно. Обычно порядок и положение параметров командной строки произвольное (т. Е. Они
может появиться где угодно). Однако, если варианты являются взаимоисключающими, крайний правый вид
используется. Такое поведение соответствует стандартным правилам оценки обычных оболочек Unix.

Кроме того, один или несколько командных файлов можно указать с помощью знака «@» в качестве префикса к
имя файла (например, @ command.txt). Такой аргумент команды заменяется содержимым
соответствующий текстовый файл (несколько пробелов рассматриваются как один разделитель, если
они помещаются между двумя кавычками) перед дальнейшей оценкой. Обратите внимание, что
командный файл не может содержать другой командный файл. Этот простой, но эффективный подход
позволяет суммировать общие комбинации опций / параметров и избегает длинных и
запутанные командные строки (пример приведен в файле /dumppat.txt).

ВЫХОД КОДЫ

Команда dcmsend Утилита использует следующие коды выхода при завершении. Это позволяет пользователю
чтобы узнать причину, по которой приложение было закрыто.

Генеральная
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

вход файл Ошибки
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

выходной файл Ошибки
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_CANNOT_WRITE_REPORT_FILE 43

сеть Ошибки
EXITCODE_CANNOT_INITIALIZE_NETWORK 60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_CANNOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

(*) На самом деле эти коды в настоящее время не используются dcmsend но служить в качестве заполнителя для
соответствующая группа кодов выхода.

ОКРУЖАЮЩАЯ СРЕДА

Команда dcmsend Утилита попытается загрузить словари данных DICOM, указанные в
ДКМДИКТПУТЬ переменная окружения. По умолчанию, т.е. если ДКМДИКТПУТЬ переменная среды
не установлен, файл /dicom.dic будет загружен, если словарь не построен
в приложение (по умолчанию для Windows).

Поведение по умолчанию должно быть предпочтительным, а ДКМДИКТПУТЬ только переменная окружения
используется, когда требуются альтернативные словари данных. В ДКМДИКТПУТЬ переменная среды
имеет тот же формат, что и оболочка Unix PATH переменная, в которой двоеточие (':') разделяет
записи. В системах Windows в качестве разделителя используется точка с запятой (';'). Словарь данных
код попытается загрузить каждый файл, указанный в ДКМДИКТПУТЬ переменная окружения. Это
является ошибкой, если невозможно загрузить словарь данных.

Используйте dcmsend онлайн с помощью сервисов onworks.net