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

CHƯƠNG TRÌNH:

TÊN

findcu - Truy vấn DICOM (C-FIND) SCU

SYNOPSIS

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

MÔ TẢ

Sản phẩm findcu ứng dụng triển khai SCU cho Lớp dịch vụ truy vấn / truy xuất và
Lớp Dịch vụ Quản lý Danh sách Công việc Cơ bản. findcu chỉ hỗ trợ chức năng truy vấn bằng cách sử dụng
tin nhắn C-FIND. Nó gửi các khóa truy vấn đến SCP và chờ phản hồi. Ứng dụng
có thể được sử dụng để kiểm tra các SCP của Dịch vụ Quản lý Danh sách Công việc Cơ bản và Truy vấn / Truy xuất
Các lớp học.

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 truy vấ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

--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ý

mạng lựa chọn
ghi đè các khóa phù hợp:

-k --key [k] ey: gggg, eeee = "str", path hoặc tên từ điển = "str"
ghi đè khóa phù hợp

mô hình thông tin truy vấn:

-W - công việc
sử dụng mô hình thông tin danh sách công việc theo phương thức (mặc định)

-P - bệnh nhân nội trú
sử dụng mô hình thông tin gốc của bệnh nhân

-S - nghiên cứu
sử dụng mô hình thông tin gốc nghiên cứu

-O - ​​chỉ một mình
sử dụng mô hình thông tin chỉ bệnh nhân / nghiên cứu

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: FINDSCU)

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

đại diện giá trị sau năm 1993:

+ u --enable-new-vr
bật hỗ trợ cho các VR mới (UN / UT) (mặc định)

-u --disable-new-vr
vô hiệu hóa hỗ trợ cho VR mới, chuyển đổi sang OB

các cú pháp chuyển truyền được đề xuất:

-x = --propose-uncompr
đề xuất tất cả TS không nén, VR rõ ràng
với thứ tự byte cục bộ đầu tiên (mặc định)

-xe --đề xuất-ít
đề xuất tất cả TS không nén, VR rõ ràng
ít endian đầu tiên

-xb --propose-to
đề xuất tất cả TS không nén, VR rõ ràng
endian lớn đầu tiên

-xd --propose-xì hơi
đề xuất giảm phát VR rõ ràng TS nhỏ endian TS
và tất cả các cú pháp chuyển không nén

-xi --propose-ẩn
chỉ đề xuất VR ít endian TS tiềm ẩn

deflate mức nén (chỉ với --propose-deflated):

+ 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 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)

--repeat [n] umber: số nguyên
lặp lại n lần

--Huỷ bỏ
hủy bỏ hiệp hội thay vì giải phóng nó

--cancel [n] umber: số nguyên
hủy sau n phản hồi (mặc định: không bao giờ)

vận chuyển lớp an ninh (TLS) lựa chọn
ngăn xếp giao thức vận tải:

-tls --disable-tls
sử dụng kết nối TCP / IP bình thường (mặc định)

+ tls --enable-tls [p] rivate key file, [c] ertificate file: string
sử dụng kết nối TLS an toàn đã được xác thực

+ tla --anonymous-tls
sử dụng kết nối TLS an toàn mà không cần chứng chỉ

mật khẩu khóa cá nhân (chỉ với --enable-tls):

+ ps --std-passwd
nhắc người dùng nhập mật khẩu trên stdin (mặc định)

+ pw --use-passwd [p] assword: string
sử dụng mật khẩu được chỉ định

-pw --null-passwd
sử dụng chuỗi trống làm mật khẩu

định dạng tệp khóa và chứng chỉ:

-pem --pem-key
đọc khóa và chứng chỉ dưới dạng tệp PEM (mặc định)

-der --der-key
đọc các khóa và chứng chỉ dưới dạng tệp DER

Chứng nhận thẩm quyền:

+ cf --add-cert-file [c] ertificate filename: string
thêm tệp chứng chỉ vào danh sách chứng chỉ

+ cd --add-cert-dir [c] ertificate directory: string
thêm chứng chỉ trong d vào danh sách chứng chỉ

bộ mật mã:

+ cs --cipher [c] iphersuite name: string
thêm ciphersuite vào danh sách các dãy đã thương lượng

+ dp --dhparam [f] ilename: string
đọc thông số DH cho mã hóa DH / DSS

trình tạo ngẫu nhiên giả:

+ rs --seed [f] ilename: string
bộ tạo ngẫu nhiên hạt giống với nội dung của f

+ ws --write-seed
viết lại hạt giống đã sửa đổi (chỉ với --seed)

+ wf --write-seed-file [f] ilename: string (chỉ với --seed)
ghi hạt giống đã sửa đổi vào tệp f

xác thực ngang hàng:

-rc --require-peer-cert
xác minh chứng chỉ ngang hàng, không thành công nếu vắng mặt (mặc định)

-vc --verify-peer-cert
xác minh chứng chỉ ngang hàng nếu có

-ic --ignore-peer-cert
không xác minh chứng chỉ ngang hàng

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

-od --output-directory [d] irectory: string (default: ".")
ghi các tập tin đầu ra vào thư mục hiện có d

tự động sửa dữ liệu:

+ dc --enable-Correction
cho phép sửa dữ liệu tự động

-dc - vô hiệu hóa-sửa
tắt sửa dữ liệu tự động (mặc định)

Câu trả lời C-FIND:

+ sr - hiển thị-phản hồi
luôn đưa ra phản hồi cho trình ghi nhật ký

-sr --hide-responsees
không xuất phản hồi cho trình ghi nhật ký

-X - đoạn trích
trích xuất câu trả lời vào tệp (rsp0001.dcm, ...)

GHI CHÚ

Mỗi tệp được cung cấp trên dòng lệnh sẽ được gửi đến SCP như một phần của C-FIND
lời yêu cầu. Tệp truy vấn phải là tập dữ liệu DICOM hợp lệ chứa phần tập dữ liệu của C-
Thông báo FIND-RQ. Ví dụ: tệp truy vấn có thể được tạo bằng bãi2dcm tiện ích
từ một tập lệnh như ví dụ sau:

# truy vấn tên và ID bệnh nhân
(0008,0052) CS [BỆNH NHÂN] # QueryRetrieveLevel
(0010,0010) PN [] # Tên bệnh nhân
(0010,0020) LO [] # ID bệnh nhân

Các thuộc tính riêng lẻ của từng tệp được gửi có thể được sửa đổi hoặc bổ sung bằng cách sử dụng -k
Lựa chọn. Ví dụ lệnh:

findcu -P -k "(0010,0010) = HEWETT *" caesar 5678 patqry.dcm

, khi được gửi đến SCP caesar tại cổng TCP / IP 5678, sẽ gây ra bất kỳ thuộc tính PatientName nào trong
patqry.dcm để có giá trị 'HEWETT *'. Nếu một thuộc tính như vậy có mặt, nó sẽ là
được thay thế, nếu vắng mặt, nó sẽ được chèn vào. Các -k tùy chọn có thể xuất hiện nhiều hơn một lần. Các
phần giá trị (sau dấu '=') có thể bị vắng mặt khiến thuộc tính được gửi bằng XNUMX
chiều dài.

Trong các phiên bản trước của findcu, các khóa thẻ được chỉ định mà không có dấu ngoặc nhọn xung quanh nhóm
và số phần tử, ví dụ: '0010,0010' thay vì '(0010,0010)'. Nó được khuyến khích
chuyển sang cú pháp mới; tuy nhiên, cú pháp cũ vẫn hoạt động.

Ngoài ra -k chấp nhận tên từ điển thay vì thẻ phần tử để chỉ định phần tử DICOM.
Ví dụ, các findcu gọi ở trên thì đọc như thế này:

findcu -P -k PatientName = "HEWETT *" caesar 5678 patqry.dcm

Cũng có thể chỉ định trình tự, mục và thuộc tính lồng nhau bằng cách sử dụng -k tùy chọn.
Trong những trường hợp này, phải sử dụng ký hiệu 'đường dẫn' đặc biệt, ví dụ:

findcu -W -k "(0040,0100) [0] .Modality = CT" caesar 5678

Cuộc gọi này truy vấn máy chủ danh sách công việc tại máy chủ lưu trữ caesar để biết bất kỳ thủ tục nào được lên kế hoạch cho CT
phương thức bằng cách chỉ định thẻ (0040,0100) 'Trình tự các bước thủ tục đã lên lịch' và một
thuộc tính "Modality" trong mục đầu tiên của chuỗi này với giá trị "CT". Chi tiết về điều này
ký hiệu đường dẫn có thể được tìm thấy trong tài liệu của dcsửa đổi.

Nếu không có tệp nào được chỉ định trên dòng lệnh, truy vấn phải được chỉ định hoàn toàn với
một hoặc nhiều -k tùy chọn. Nếu nhiều tệp truy vấn được cung cấp, findcu sẽ gửi nhiều
C-TÌM yêu cầu đối với SCP.

Mỗi bộ số nhận dạng phản hồi nhận được sẽ được xuất ra trình ghi nhật ký trừ khi tùy chọn
--hide-response, --trích xuất, --Yên lặng hoặc một cấu hình ghi nhật ký thích hợp được sử dụng.
Tùy chọn --show-response có thể được sử dụng để buộc đầu ra cho bộ ghi.

DICOM Sự phù hợp
Sản phẩm findcu ứng dụng hỗ trợ các Lớp SOP sau dưới dạng SCU:

FINDPatologyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.1
FINDStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.1
FINDPatologyStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.1
FINDModalityWorklistInformationMô hình 1.2.840.10008.5.1.4.31

Sản phẩm findcu ứng dụng sẽ đề xuất các bối cảnh trình bày cho một trong những điều đã đề cập ở trên
Các lớp SOP được hỗ trợ tùy thuộc vào các tùy chọn dòng lệnh (-P, -S, -O or -W). Về cơ bản,
các cú pháp chuyển khoản sau được hỗ trợ:

LittleEndianImplicitTransferCú pháp 1.2.840.10008.1.2
LittleEndianExplicitTransferCú pháp 1.2.840.10008.1.2.1
DeflateExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferCú pháp 1.2.840.10008.1.2.2

(*) nếu được biên dịch với hỗ trợ zlib được bật (xem --phiên bản đầu ra)

Các cú pháp chuyển tiền nào thực sự được đề xuất theo thứ tự nào, có thể được chỉ định bằng
--cầu hôn tùy chọn.

Sản phẩm findcu ứng dụng không hỗ trợ thương lượng mở rộng.

ĐĂ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).

MÔI TRƯỜNG

Sản phẩm findcu 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 findcu trực tuyến bằng các dịch vụ onworks.net