dcmsend - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dcmsend - SCU lưu trữ DICOM đơn giản (người gửi)

SYNOPSIS

dcmsend [tùy chọn] cổng ngang hàng dcmfile-in ...

MÔ TẢ

Sản phẩm dcmsgửi ứng dụng triển khai Người dùng lớp dịch vụ (SCU) cho Dịch vụ lưu trữ
Lớp. Ngược lại với cái nổi tiếng cửa hàng tiện ích, dcmsgửi có ít lựa chọn hơn và
do đó, dễ sử dụng hơn - điều này cũng giải thích thuật ngữ 'đơn giản' trong tiêu đề. Chính
mục đích của ứng dụng này là gửi một loạt các tệp DICOM đến một Dịch vụ Lưu trữ
Nhà cung cấp Lớp học (SCP). dcmsgửi hỗ trợ cả nhiều liên kết (cái này đến cái kia)
và giải nén các cá thể DICOM SOP nếu cần để chuyển chúng.

THÔNG SỐ

tên máy chủ ngang hàng của máy chủ ngang hàng DICOM

số cổng tcp / ip của cổng ngang hàng

dcmfile-in DICOM tệp hoặc thư mục sẽ được truyền

LỰA CHỌN

chung lựa chọn
-h - trợ giúp
in văn bản trợ giúp này và thoát

--phiên bản
in thông tin phiên bản và thoát

- bộ giải mã danh sách
liệt kê các cú pháp chuyển của bộ giải mã và thoát

--tranh luận
in các đối số dòng lệnh mở rộng

-q --im lặng
chế độ yên tĩnh, in không có cảnh báo và lỗi

-v --dài dòng
chế độ tiết, chi tiết xử lý in

-d --gỡ lỗi
chế độ gỡ lỗi, in thông tin gỡ lỗi

-ll --log-level [l] evel: hằng số chuỗi
(nghiêm trọng, lỗi, cảnh báo, thông tin, gỡ lỗi, theo dõi)
sử dụng mức l cho trình ghi nhật ký

-lc --log-config [f] ilename: string
sử dụng tệp cấu hình f cho trình ghi nhật ký

+ v --verbose-pc
hiển thị các ngữ cảnh trình bày ở chế độ tiết

đầu vào lựa chọn
định dạng tệp đầu vào:

+ f --read-file
đọc định dạng tệp hoặc tập dữ liệu

+ fo - chỉ đọc-tệp
chỉ đọc định dạng tệp (mặc định)

-f --read-dataset
đọc tập dữ liệu mà không có thông tin meta tệp

tệp đầu vào:

+ rd --read-from-dicomdir
đọc thông tin trên các tệp đầu vào từ DICOMDIR

+ sd --scan-thư mục
quét thư mục để tìm tệp đầu vào (dcmfile-in)

+ sp --scan-pattern [p] attern: string (chỉ với --scan-directory)
mẫu cho khớp tên tệp (ký tự đại diện)

# có thể không khả dụng trên tất cả các hệ thống

-r - không đệ quy
không đệ quy trong thư mục (mặc định)

+ r --recurse
đệ quy trong các thư mục được chỉ định

xử lý lựa chọn
chuyển đổi cú pháp chuyển đổi:

-dn --decompress-không bao giờ
không bao giờ giải nén các tập dữ liệu nén

+ dls --decompress-lossless
chỉ giải nén nén không mất dữ liệu (mặc định)

+ dly --decompress-Lossy
giải nén cả nén mất dữ liệu và nén không mất dữ liệu

giảm phát mức độ nén:

+ cl --compression-level [l] evel: integer (mặc định: 6)
0 = không nén, 1 = nhanh nhất, 9 = nén tốt nhất

các tùy chọn xử lý khác:

-nh - không dừng lại
không dừng lại ở tệp đầu vào không hợp lệ đầu tiên
hoặc nếu gặp phải cửa hàng không thành công

-nip - không-bất hợp pháp-đề xuất
không đề xuất bất kỳ bối cảnh trình bày nào
không chứa cú pháp chuyển mặc định (nếu cần)

-nuc --no-uid-kiểm tra
không kiểm tra giá trị UID của các tệp đầu vào

mạng lựa chọn
tiêu đề thực thể ứng dụng:

-aet --aetitle [a] etitle: string
đặt tiêu đề AE đang gọi của tôi (mặc định: DCMSEND)

-aec --call [a] etitle: string
đặt tên gọi AE là tiêu đề ngang hàng (mặc định: BẤT KỲ-SCP)

xử lý liên kết:

+ ma - nhiều hiệp hội
sử dụng nhiều liên kết (cái này đến cái khác)
nếu cần để chuyển các phiên bản (mặc định)

-ma - liên kết đơn
luôn sử dụng một liên kết duy nhất

các tùy chọn mạng khác:

-to --timeout [s] econds: integer (mặc định: không giới hạn)
thời gian chờ cho các yêu cầu kết nối

-ta --acse-timeout [s] econds: integer (mặc định: 30)
thời gian chờ cho tin nhắn ACSE

-td --dimse-timeout [s] econds: integer (mặc định: không giới hạn)
thời gian chờ cho tin nhắn DIMSE

-pdu --max-pdu [n] umber of byte: integer (4096..131072)
đặt pdu nhận tối đa thành n byte (mặc định: 16384)

--max-send-pdu [n] umber of byte: integer (4096..131072)
hạn chế gửi pdu tối đa đến n byte

đầu ra lựa chọn
chung:

+ crf --create-report-file [f] ilename: string
tạo một báo cáo chi tiết về việc chuyển nhượng
(nếu thành công) và ghi nó vào tệp văn bản f

GHI CHÚ

Điển hình Sử dụng
Một trường hợp sử dụng điển hình của dcmsgửi là gửi các phiên bản SOP tùy ý được lưu trữ dưới dạng DICOM
các tệp vào một SCP lưu trữ. Lệnh sau thực hiện chính xác điều này:

dcmsend --verbose * .dcm

Nếu các tệp DICOM được lưu trữ trong một hệ thống phân cấp các thư mục bên dưới thư mục 'IMAGES',
lệnh sau có thể được sử dụng:

dcmsend -v --scan-directory - ghi lại HÌNH ẢNH

Cũng có thể chỉ định nhiều thư mục và kết hợp các
phương pháp tiếp cận (sử dụng cả tên tệp và thư mục):

dcmsend -v + sd + r IMAGES_1 IMAGES_2 test.img * .dcm

Nếu các phiên bản SOP được tham chiếu từ tệp DICOMDIR, tùy chọn --read-từ-dicomdir (Hoặc
+ rd) có thể được sử dụng để gửi tất cả các tệp DICOM được tham chiếu mà không cần tải chúng cho
thương lượng liên kết:

dcmsend -v --read-from-dicomdir DICOMDIR

Và một lần nữa, tất cả các phương pháp trên có thể được kết hợp như sau:

dcmsend -v + sd + r + rd IMAGES_1 IMAGES_2 test.img DICOMDIR * .dcm

Tùy chọn mặc định - chỉ đọc-tệp đảm bảo rằng chỉ các tệp DICOM (tức là những tệp có
meta-header và từ ma thuật 'DICM' sau phần mở đầu) được xử lý. Thông thường, nếu
xử lý toàn bộ nhiều tệp, bạn cũng nên dừng lại ở tệp không hợp lệ đầu tiên
tập tin đầu vào hoặc nếu gặp phải trường hợp lưu trữ không thành công. Điều này có thể được thực hiện bằng cách sử dụng
tùy chọn - không dừng lại. Xin lưu ý, tuy nhiên, 'cửa hàng không thành công' không có nghĩa là
Trạng thái DIMSE của phản hồi C-STORE chỉ ra một lỗi. Có nghĩa là yêu cầu C-STORE
không thể được gửi đến SCP lưu trữ.

Nếu cần nhiều hơn 128 ngữ cảnh trình bày, đó là số lượng tối đa cho phép
theo tiêu chuẩn DICOM, một liên kết mới được bắt đầu sau khi liên kết trước đó có
đã được hoàn thành. Trong trường hợp không mong muốn hành vi này, nó có thể bị vô hiệu hóa bằng cách sử dụng tùy chọn
- liên kết đơn. Ngoài ra, liệu chỉ các tập dữ liệu nén không mất dữ liệu
được giải nén (nếu cần), là mặc định, hoặc các tập dữ liệu nén bị mất cũng có thể được
được chỉ định bằng cách sử dụng --giải nén-xxx tùy chọn.

Để có được cả thông tin tổng quan và chi tiết về việc chuyển giao DICOM SOP
phiên bản, tùy chọn --tạo-báo cáo-tệp có thể được sử dụng để tạo một tệp văn bản tương ứng.
Tuy nhiên, tệp này chỉ được tạo ở bước cuối cùng nếu ứng dụng không kết thúc
trước (có lỗi).

Quét (scanning) Danh Mục
Thêm thư mục làm tham số vào dòng lệnh chỉ có ý nghĩa nếu tùy chọn --quét-
thư mục cũng được đưa ra. Nếu các tệp trong thư mục được cung cấp nên được chọn
theo một mẫu tên cụ thể (ví dụ: sử dụng đối sánh ký tự đại diện), tùy chọn --mẫu quét
phải được sử dụng. Xin lưu ý rằng mẫu tệp này chỉ áp dụng cho các tệp trong
các thư mục được quét và nếu có bất kỳ mẫu nào khác được chỉ định trên dòng lệnh bên ngoài
các --mẫu quét (ví dụ: để chọn các tệp khác), các tùy chọn này không áp dụng cho
các thư mục được chỉ định.

Do đó, một phần ba trong số các ví dụ trên sẽ lặp lại trên các thư mục IMAGES_1 và IMAGES_2
và truyền các tệp được chứa trong hai thư mục này và tất cả các thư mục con của chúng (do
tùy chọn +r). Ngoài ra, dcmsgửi sẽ chuyển 'test.img' và tất cả các tệp có phần mở rộng
'dcm' từ thư mục làm việc hiện tại. Lưu ý rằng việc cung cấp tên thư mục mà không có
tùy chọn kích hoạt + sd không có ý nghĩa.

DICOM Sự phù hợp
Về cơ bản, dcmsgửi ứng dụng hỗ trợ tất cả các Lớp SOP lưu trữ như một SCU, bao gồm
những cái riêng tư. Theo mặc định, ứng dụng kiểm tra UID Lớp SOP của tệp DICOM trong
để đảm bảo rằng chỉ các phiên bản SOP hợp lệ mới được gửi. Với tùy chọn --no-uid-séc
kiểm tra này có thể bị vô hiệu hóa.

Sản phẩm dcmsgửi ứng dụng cũng hỗ trợ tất cả các Cú pháp chuyển được xác định trong DICOM
Tiêu chuẩn. Cú pháp chuyển riêng chỉ có thể được sử dụng nếu tính năng kiểm tra UID bị tắt với
tùy chọn --no-uid-séc. Xin lưu ý, tuy nhiên, chỉ có một số lượng hạn chế chuyển
các cú pháp được hỗ trợ để chuyển đổi chúng thành cú pháp chuyển mặc định (VR ngầm định
Endian nhỏ). Với tùy chọn - bộ giải mã danh sách các cú pháp chuyển được hỗ trợ nguyên bản hoặc bởi
bộ giải mã được liệt kê. Đầu ra thường giống như sau:

Các cú pháp chuyển được hỗ trợ nguyên bản:
- Ngụ ý Little Endian
- Little Endian rõ ràng
- Big Endian rõ ràng

Các cú pháp chuyển được hỗ trợ bởi bộ giải mã:
- Little Endian VR rõ ràng bị xì hơi
- Đường cơ sở JPEG
- JPEG Mở rộng, Quy trình 2 + 4
- Lựa chọn phổ JPEG, Không phân cấp, Quy trình 6 + 8
- Tiến trình đầy đủ JPEG, Không phân cấp, Quy trình 10 + 12
- JPEG Lossless, Không phân cấp, Quy trình 14
- JPEG không mất mát, không phân cấp, dự đoán đơn hàng đầu tiên
- JPEG-LS không mất dữ liệu
- JPEG-LS Lossy (Gần như không mất dữ liệu)
- RLE không mất mát

từ dcmsgửi cố gắng trở nên đơn giản nhất có thể cho người dùng, theo bản trình bày mặc định
các bối cảnh có thể được đề xuất cho SCP mà nói chính xác là 'bất hợp pháp'. Đây là
bởi vì, theo tiêu chuẩn DICOM, SCU luôn phải đề xuất giá trị mặc định
chuyển cú pháp trong ít nhất một ngữ cảnh trình bày được liên kết với mỗi cú pháp trừu tượng
(tức là lớp SOP). Yêu cầu này được miễn khi SCU chỉ có quyền truy cập vào SOP
ví dụ ở dạng nén mất dữ liệu. Với tùy chọn - không-bất hợp pháp-đề xuất DICOM nghiêm ngặt-
hành vi tuân thủ có thể được thực thi, tức là sẽ không có ngữ cảnh trình bày bất hợp pháp nào được
được đề xuất nhưng phiên bản SOP tương ứng sẽ bị từ chối (nếu cần).

Tuy nhiên, xin lưu ý rằng cú pháp chuyển mặc định cho 'Nén JPEG không mất dữ liệu',
'Nén JPEG mất dữ liệu', v.v. không phải lúc nào cũng được đề xuất theo yêu cầu của DICOM
Tiêu chuẩn. Hạn chế tương tự cũng áp dụng cho các chương trình nén khác. Xem DICOM PS 3.5
phần 10 để biết chi tiết.

ĐĂNG NHẬP

Mức độ xuất nhật ký của các công cụ dòng lệnh khác nhau và các thư viện cơ bản có thể
được chỉ định bởi người dùng. Theo mặc định, chỉ các lỗi và cảnh báo được ghi theo tiêu chuẩn
dòng lỗi. Sử dụng tùy chọn --dài dòng cũng như các tin nhắn thông tin như xử lý chi tiết
được báo cáo. Lựa chọn --gỡ lỗi có thể được sử dụng để biết thêm chi tiết về hoạt động nội bộ,
ví dụ: cho mục đích gỡ lỗi. Các cấp độ ghi nhật ký khác có thể được chọn bằng cách sử dụng tùy chọn --log-
cấp. Trong --Yên lặng chế độ chỉ có lỗi nghiêm trọng được báo cáo. Trong các sự kiện lỗi rất nghiêm trọng như vậy,
ứng dụng thường sẽ kết thúc. Để biết thêm chi tiết về các cấp độ ghi nhật ký khác nhau,
xem tài liệu của mô-đun 'oflog'.

Trong trường hợp kết quả ghi nhật ký phải được ghi vào tệp (tùy chọn với xoay tệp nhật ký),
đến nhật ký hệ thống (Unix) hoặc tùy chọn nhật ký sự kiện (Windows) --log-config có thể được sử dụng. Cái này
tệp cấu hình cũng chỉ cho phép chuyển hướng một số thông báo đến một đầu ra cụ thể
luồng và để lọc các thư nhất định dựa trên mô-đun hoặc ứng dụng nơi chúng
Được tạo ra. Một tệp cấu hình mẫu được cung cấp trong /logger.cfg.

COMMAND ĐƯỜNG DÂY

Tất cả các công cụ dòng lệnh sử dụng ký hiệu sau cho các tham số: dấu ngoặc vuông bao quanh
giá trị tùy chọn (0-1), ba dấu chấm ở cuối cho biết rằng nhiều giá trị được phép
(1-n), kết hợp của cả hai có nghĩa là giá trị từ 0 đến n.

Các tùy chọn dòng lệnh được phân biệt với các tham số bằng dấu '+' hoặc '-' đứng đầu,
tương ứng. Thông thường, thứ tự và vị trí của các tùy chọn dòng lệnh là tùy ý (tức là chúng
có thể xuất hiện ở bất kỳ đâu). Tuy nhiên, nếu các tùy chọn loại trừ lẫn nhau, sự xuất hiện ngoài cùng bên phải
Được sử dụng. Hành vi này tuân theo các quy tắc đánh giá tiêu chuẩn của các trình bao Unix phổ biến.

Ngoài ra, một hoặc nhiều tệp lệnh có thể được chỉ định bằng cách sử dụng dấu '@' làm tiền tố cho
tên tệp (ví dụ: @ command.txt). Đối số lệnh như vậy được thay thế bằng nội dung của
tệp văn bản tương ứng (nhiều khoảng trắng được coi như một dấu phân tách duy nhất trừ khi
chúng xuất hiện giữa hai dấu ngoặc kép) trước khi đánh giá thêm. Xin lưu ý rằng
tệp lệnh không được chứa tệp lệnh khác. Cách tiếp cận đơn giản nhưng hiệu quả này
cho phép người ta tóm tắt các kết hợp phổ biến của các tùy chọn / tham số và tránh dài dòng và
các dòng lệnh khó hiểu (một ví dụ được cung cấp trong tệp /dumppat.txt).

EXIT MÃ

Sản phẩm dcmsgửi tiện ích sử dụng các mã thoát sau khi kết thúc. Điều này cho phép người dùng
để kiểm tra lý do tại sao ứng dụng bị chấm dứt.

chung
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

đầu vào hồ sơ lỗi
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

đầu ra hồ sơ lỗi
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_CANNOT_WRITE_REPORT_FILE 43

mạng lỗi
EXITCODE_CANNOT_INITIALIZE_NETWORK 60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_CANNOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

(*) Trên thực tế, những mã này hiện không được sử dụng bởi dcmsgửi nhưng phục vụ như một trình giữ chỗ cho
nhóm mã thoát tương ứng.

MÔI TRƯỜNG

Sản phẩm dcmsgửi tiện ích sẽ cố gắng tải từ điển dữ liệu DICOM được chỉ định trong
DCMDICTPATH biến môi trường. Theo mặc định, tức là nếu DCMDICTPATH biến môi trường
không được thiết lập, tệp /dicom.dic sẽ được tải trừ khi từ điển được xây dựng
vào ứng dụng (mặc định cho Windows).

Hành vi mặc định nên được ưu tiên và DCMDICTPATH chỉ biến môi trường
được sử dụng khi từ điển dữ liệu thay thế được yêu cầu. Các DCMDICTPATH biến môi trường
có cùng định dạng với Unix shell PATH biến trong đó dấu hai chấm (':') ngăn cách
mục. Trên hệ thống Windows, dấu chấm phẩy (';') được sử dụng làm dấu phân cách. Từ điển dữ liệu
mã sẽ cố gắng tải từng tệp được chỉ định trong DCMDICTPATH biến môi trường. Nó
là một lỗi nếu không có từ điển dữ liệu nào có thể được tải.

Sử dụng dcmsend trực tuyến bằng các dịch vụ onworks.net