img2dcm - 클라우드의 온라인

프로그램:

이름

img2dcm - 표준 이미지 형식을 DICOM 형식으로 변환

개요

img2dcm [옵션] imgfile-in dcmfile-out

기술

XNUMXD덴탈의 img2dcm 도구는 JPEG 또는 BMP와 같은 표준 이미지 형식에서 변환 도구 역할을 합니다.
DICOM에. 다른 출력 SOP 클래스를 선택할 수 있습니다. 추가 정보
(관련 환자, 시리즈 등) DICOM 출력 파일에 저장된
결과 DICOM 개체의 '템플릿' 역할을 하는 다른 DICOM 파일. img2dcm
누락된 DICOM 유형 1 및 유형 2 속성도 작동하도록 구성할 수 있습니다.
템플릿 데이터 세트가 없습니다.

매개 변수

가져올 imgfile-in 이미지 파일

dcmfile-out DICOM 출력 파일

옵션

일반 옵션
-h --도움말
이 도움말 텍스트를 인쇄하고 종료하십시오.

--번역
버전 정보를 출력하고 종료

--인수
확장된 명령줄 인수 인쇄

-q --조용한
자동 모드, 경고 및 오류 인쇄 없음

-v --장황
상세 모드, 인쇄 처리 세부 정보

-d --디버그
디버그 모드, 디버그 정보 인쇄

-ll --log-level [l]레벨: 문자열 상수
(치명적, 오류, 경고, 정보, 디버그, 추적)
로거에 레벨 l 사용

-lc --log-config [f]파일 이름: 문자열
로거에 구성 파일 f 사용

입력 옵션
일반:

-i --input-format [i]nput 파일 형식: 문자열
지원되는 형식: JPEG(기본값), BMP

-df --dataset-from [f]파일 이름: 문자열
DICOM 파일 f의 데이터 세트 사용

-stf --study-from [f]파일 이름: 문자열
DICOM 파일에서 환자/연구 읽기 f

-sef --series-from [f]파일 이름: 문자열
DICOM 파일에서 환자/연구/시리즈 읽기 f

-ii --인스턴스-inc
DICOM 파일에서 읽은 인스턴스 번호 증가

JPEG 형식:

-dp --비활성화-프로그램
프로그레시브 JPEG 지원 비활성화

-de --disable-ext
확장 순차 JPEG 지원 비활성화

-jf --jfif 주장
JFIF 헤더 존재 주장

-ka --keep-appn
APPn 섹션 유지(JFIF 제외)

처리 옵션
속성 확인:

--do-checks
속성 유효성 검사 활성화(기본값)

--확인하지 않음
속성 유효성 검사 비활성화

+i2 --삽입 유형2
누락된 유형 2 속성 삽입(기본값)
(--do-checks에서만)

-i2 --no-type2-삽입
누락된 유형 2 속성을 삽입하지 마십시오.
(--do-checks에서만)

+i1 --발명 유형1
누락된 유형 1 속성 발명
(--do-checks에서만)

-i1 --no-type1-invent
누락된 유형 1 속성을 발명하지 마십시오.
(--do-checks에서만)

문자 집합:

+l1 --라틴어1
latin-1을 표준 문자 집합으로 설정(기본값)

-l1 --no-latin1
7비트 ASCII를 표준 문자 집합으로 유지

기타 처리 옵션:

-k --key [k]key: gggg,eeee="str", 경로 또는 사전 이름="str"
추가 속성 추가

출력 옵션
대상 SOP 클래스:

-sc --sec-캡처
보조 캡처 SOP 클래스 작성

-nsc --new-sc
새 보조 캡처 SOP 클래스 작성

-vlp --vl-사진
가시광선 사진 SOP 클래스 작성(기본값)

출력 파일 형식:

+F --파일 쓰기
쓰기 파일 형식(기본값)

-F --쓰기 데이터 세트
파일 메타 정보 없이 데이터 세트 쓰기

그룹 길이 인코딩:

+g= --그룹 길이 재계산
그룹 길이가 있는 경우 다시 계산(기본값)

+g --그룹 길이 생성
항상 그룹 길이 요소로 작성

-g --그룹 길이 제거
항상 그룹 길이 요소 없이 작성

시퀀스 및 항목의 길이 인코딩:

+e --길이-명시적
명시적 길이로 쓰기(기본값)

-e --길이 정의되지 않음
정의되지 않은 길이로 쓰기

데이터 세트 후행 패딩(--write-dataset 제외):

-p --패딩 오프
패딩 없음(--write-dataset인 경우 암시적)

+p --padding-create [파일]패드 [i]템패드: 정수
f 바이트의 배수에 파일 정렬
및 i 바이트 배수의 항목

노트

속성 지우면 좋을거같음 . SM
일반적인 이미지 형식을 DICOM 형식으로 변환하려면 img2dcm 응용 프로그램이 될 수 있습니다
새 항목에서 필수(및 선택적) 속성을 채우기 위한 몇 가지 추가 입력이 제공됩니다.
환자, 연구 및 시리즈 정보와 같은 DICOM 파일. 이 정보는 수집될 수 있습니다
결합할 수 있고 결과 파일에 적용할 수 있는 다양한 접근 방식 사용
다음 순서:

· 사용 --데이터세트-from 선택권 img2dcm 기존에서 속성을 가져와야 합니다.
DICOM 파일. 주어진 DICOM 파일은 완전히 가져오고 모든
추가 수출 작업. 예외적으로 SOP 인스턴스 UID는 이것으로 복사되지 않습니다.
옵션. 또한 행, 열 등과 같은 이미지 관련 데이터는 변환 중에 교환됩니다.
참고 img2dcm 타당성을 위해 다른 속성 값을 확인하지 않습니다. 예를 들어 확인합니다.
새 객체에 속성을 적용하기 위해 시퀀스를 조사하지 않습니다(참조된 이미지
등.). 따라서 (구)용 데이터 디렉토리의 템플릿을 사용하는 것이 좋습니다.
SC 및 VLP 객체. '입력 템플릿' 섹션도 참조하십시오.
· --학습-출처 과 --시리즈-출처 옵션(상호 배타적)을 사용하여 가져올 수 있습니다.
기존 DICOM 파일의 환자, 연구 및 시리즈 정보. 만약에 --시리즈-출처 is
지정하면 주어진 DICOM 파일이 다음으로 열립니다. img2dcm 및 모든 필수 정보
시리즈 레벨까지 가져옵니다. 여기에는 환자, 연구 및 시리즈가 포함됩니다.
정보. 의 경우 --학습-출처, 시리즈 정보는 제외됩니다. 다음과 같은
다음 속성이 인계됩니다.
환자 수준:
환자 이름
환자 ID
환자의 성별
환자의 생년월일
특정 문자 세트

학습 레벨 :
연구 인스턴스 UID
연구 날짜
학습 시간
추천 의사의 이름
연구 ID
가입 번호

시리즈 레벨(--series-from 옵션의 경우에만):
시리즈 인스턴스 UID
시리즈 번호
제조업 자
· 이랑 --삽입 유형2 과 --발명-유형1 옵션(둘 다 기본적으로 활성화됨), 누락
속성(유형 2 속성) 및/또는 누락된 속성 값(유형 1 속성의 경우)
에 의해 자동으로 추가되고 발명됩니다. img2dcm. 이 옵션은
옵션인 경우 평가 --do-checks 활성화됩니다(기본값). 만약 --확인하지 않음 옵션은
활성화하면 자동 속성 삽입이 수행되지 않습니다.
· --열쇠 옵션을 사용하여 DICOM 출력 파일에 속성을 더 추가할 수 있습니다. 이것
옵션은 맨 마지막에 DICOM 파일을 저장하기 직전에 적용됩니다. 그것은 또한
를 사용하여 시퀀스, 항목 및 중첩 속성을 지정할 수 있습니다. --열쇠 옵션. 에
이러한 경우 특별한 '경로' 표기법을 사용해야 합니다. 이 경로 표기법에 대한 자세한 내용은
의 문서에서 찾을 수 있습니다. dc수정.
UID
새 연구 및 시리즈 인스턴스 UID가 생성됩니다. if 필요한 적용 후 --공부하다-
에 과 --시리즈 옵션. 연구 인스턴스 UID 또는 시리즈 인스턴스 UID가 없는 경우
이러한 단계 후에 서로 독립적으로 새로 생성됩니다. 반대
인계될 것으로 예상되는 SOP 인스턴스 UID에 대해 동작이 선택됩니다.
를 사용하여 --데이터세트-from 옵션. 이것은 지원 이 경우 SOP 인스턴스 UID는 지원 복사
새 개체에. 이것은 대부분의 사용 사례에서 바람직한 동작이어야 합니다. 그러나 만약
특정 SOP 인스턴스 UID를 새 개체에 삽입해야 합니다. --열쇠 옵션은
사용하십시오.
입력 Canva의 제작된 채널아트 템플릿을
DICOM으로 변환 지원을 위해, img2dcm 일부 사전 정의된 템플릿과 함께 제공
에 사용할 수 있는 --데이터세트-from 옵션(샘플 파일 참조 SC 덤프 과 VLP.덤프).
이러한 템플릿은 원하는 값으로 채워진 다음 덤프되어야 합니다.
(변환) 실제로 사용하기 전에 DICOM 파일로 img2dcm. 사용 덤프2dcm 에
덤프를 DICOM으로 변환합니다. 예:
dump2dcm SC.덤프 SC.dcm

모든 DICOM 파일을 템플릿으로 사용할 수 있습니다. 완전한 DICOM
데이터 세트를 가져옵니다. 따라서 속성만 존재한다는 것이 보장되어야 합니다.
구성된 DICOM 개체의 일부여야 합니다. SOP 클래스 UID 및 픽셀 데이터
속성(행, 열 등과 같은 속성 포함)은 복사되지 않지만
img2dcm 전환 중.
입력 플러그인
XNUMXD덴탈의 img2dcm 응용 프로그램은 현재 JPEG 및 BMP 이미지 형식을 입력으로 지원합니다.
JPEG 입력 플러그인
JPEG의 경우 소스 파일의 원본 JPEG가 디코딩되지 않고 추출되며 약간
큰 JPEG 파일도 빠르게 변환할 수 있도록 변환(예: JFIF 헤더가 잘림)
디코딩 및 재인코딩이 필요하지 않습니다. JPEG 플러그인은 필요한 출력을 선택합니다.
JPEG 내부 데이터의 실제 인코딩에 따라 구문을 자동으로 전송
파일. 따라서 다음 전송 구문(및 해당 JPEG 인코딩)
JPEG 플러그인에서 사용됩니다.
· JPEG 코딩 프로세스 1 Baseline, Lossy, Non-Hierarchical, Sequential, DCT, Huffman, 8 Bit
SOP 클래스 = 1.2.840.10008.1.2.4.50
· JPEG 코딩 프로세스 2(8비트) 및 4(12비트) 확장, 손실, 비계층,
순차, DCT, 허프만, 8/12비트 SOP 클래스 = 1.2.840.10008.1.2.4.51
· JPEG 코딩 프로세스 10(8비트) 및 12(12비트) 전체 진행, 손실, 비계층,
프로그레시브, DCT, 허프만, 8/12비트 SOP 클래스 = 1.2.840.10008.1.2.4.55
컬러 및 그레이스케일 이미지가 지원됩니다.
확장 JPEG 전송 구문에 대한 지원을 비활성화할 수 있습니다(--비활성화-ext 선택권)
뿐만 아니라 (중단된) 프로그레시브 JPEG 전송 구문에 대한 지원(--비활성화 프로그램
선택권).
JPEG 무손실 인코딩과 모든 산술 또는 계층적 JPEG 인코딩 모드는
플러그인에서 지원하지 않습니다.
JFIF(JPEG File Interchange Format) 정보는
JPEG 파일. 많은 디지털 카메라는 이러한 JFIF 정보를 JPEG에 통합하지 않습니다.
그들이 생성하는 출력. 예를 들어 JFIF에는 다음의 픽셀 종횡비에 대한 정보가 포함되어 있습니다.
압축된 이미지. 원하는 경우 img2dcm JFIF 헤더를 주장하는 애플리케이션
JPEG 스트림, 당신은 옵션을 사용할 수 있습니다 --jfif 주장 JFIF가 없으면 중단됩니다.
정보를 찾을 수 있습니다. 기본적으로 누락된 JFIF 정보는 무시됩니다.
DICOM의 경우 JFIF(또는 다른 APPn)의 통합 여부에 관계없이 일종의 '회색 영역'입니다.
DICOM 개체의 내부 JPEG 스트림으로의 데이터 전송이 허용되는지 여부입니다. 그러나 가장
신뢰할 수 있는 접근 방식은 이러한 마커와 해당 정보를 JPEG 스트림에서 잘라내는 것입니다. 이것
접근 방식은 img2dcm 애플리케이션. 기본적으로 모든 APPn 마커는 잘립니다.
원래 JPEG 스트림에서 꺼집니다. 그러나 다른 APPn 마커를 유지하려면
DICOM 스트림 내부의 JFIF(예: EXIF ​​정보), 옵션 --앱 유지 ~한다.
장난. 또한 APPn 정보를 차단하는 것보다 약간 더 빠를 것입니다.
이러한 데이터에 대해 전체 JPEG 스트림을 스캔할 필요가 없습니다. JFIF 정보는 항상
제거 img2dcm.
BMP 입력 플러그인
img2dcm 입력 형식으로 BMP를 지원합니다. 그러나 지금까지 가장 일반적인 BMP 이미지만
지원됩니다. 특히 비트 필드 또는 런 렝스 인코딩을 사용하는 BMP 이미지는
거부되었습니다. 그러한 이미지는 흔하지 않습니다. 모든 입력 이미지는 DICOM 이미지로 변환됩니다.
RGB 색상 모델 및 비트 심도 24. 미세 조정을 위한 특정 옵션이 없습니다.
BMP 형식 변환.
산출 플러그인
원하는 출력 SOP 클래스는 명령줄에서 선택할 수 있습니다. 현재는 수출
Secondary Capture Image SOP 클래스용 플러그인(기본값, 옵션 -Sc), 새로운 보조
캡처 이미지 SOP 클래스(옵션 -nsc) 및 가시 광선 사진 이미지 SOP 클래스
(선택권 -vl) 사용할 수 있습니다. 첫 번째는 에 따라 더 이상 사용되지 않습니다.
DICOM 표준이지만 광범위하게 지원되므로 기본값으로 선택됩니다. 미래
버전 img2dcm 다른 SOP 클래스에 대한 추가 출력 플러그인을 제공할 수 있습니다.
새로운 Secondary Capture SOP 클래스의 경우 특정 클래스를 지정할 수 없습니다.
출력에는 SOP 클래스를 사용해야 합니다. 이는 이러한 새로운 SOP 클래스가
색 심도(1/8/16)와 이미지가
흑백 또는 컬러. 그래서 img2dcm 출력 SOP를 변환하는 동안 결정합니다.
클래스는 주어진 소스 이미지에 적합합니다.

사용 예

다음은 방법을 보여주는 몇 가지 예입니다. img2dcm 응용 프로그램을 사용할 수 있습니다.
1. img2dcm 이미지.jpg out.dcm
JPEG 파일 'image.jpg'를 읽고 이전 Secondary Capture SOP 클래스로 변환하여 저장
DICOM 파일 'out.dcm'에 대한 결과. 가장 사용하기 쉬운 방법입니다 img2dcm. 어떤 유형
이 SOP 클래스의 유효한 개체를 작성하는 데 필요한 1 및 유형 2 속성은 다음과 같습니다.
자동으로 삽입됩니다.
2. img2dcm -i BMP 이미지.bmp 출력.dcm
위와 동일하지만 img2dcm에게 JPEG 대신 BMP 파일을 읽도록 지시합니다.
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
첫 번째 예제와 동일하나 'out.dcm'에 Visible Light Photographic Image 객체를 쓴다.
그리고 PatientName을 'Bond^James'로 설정합니다. 그렇지 않으면 비어 있게 됩니다.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
1)과 같지만 DICOM 파일에서 환자/연구/시리즈 정보를 가져옵니다.
'템플릿.dcm'. 속성 PatientName에는 'Bond^James'가 포함됩니다.
마지막으로 'template.dcm'의 모든 값을 덮어씁니다. 즉, -k 때문에
옵션은 변환 파이프라인의 맨 끝에 적용됩니다(위 참조).
5. img2dcm image.jpg out.dcm --체크 없음
1)과 동일하지만 속성 검사를 수행하지 않으며 유형 1 및 유형 2가 없습니다.
속성 삽입! 따라서 이 경우 잘못된 DICOM 개체가 생성됩니다. 이것
출력 파일이 완료될 의도가 아니라 수행될 경우 흥미로울 수 있습니다.
추가 변환, 예: 다음을 사용하여 속성 추가 dc수정. 옵션만 사용 --아니요-
체크 무늬 당신이 무엇을하는지 알고 있다면!
6. img2dcm image.jpg out.dcm --no-type1-invent
1)과 동일하지만 누락된 유형 1 속성 및/또는 해당 값을 삽입하지 않습니다. 유형 2
속성이 삽입됩니다. 이 경우 모든 유형 1이 보장되어야 합니다.
속성은 다른 방법으로 제공됩니다. --열쇠 옵션을 선택합니다.
그렇지 않으면, img2dcm 오류를 보고하고 변환을 중지합니다.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
1)과 같지만 EXIF와 같은 APPn 정보를 DICOM 객체의
결과 JPEG 스트림. 더 나아가, --jfif 주장 강제할 것이다 img2dcm 없으면 중단
JFIF 정보는 소스 파일에 존재합니다.

벌채 반출

다양한 명령줄 도구 및 기본 라이브러리의 로깅 출력 수준은
사용자가 지정해야 합니다. 기본적으로 오류와 경고만 표준에 기록됩니다.
오류 스트림. 옵션 사용 --말 수가 많은 처리 세부 정보와 같은 정보 메시지
보고된다. 옵션 -디버그 내부 활동에 대한 자세한 정보를 얻는 데 사용할 수 있습니다.
예를 들어 디버깅 목적으로. 옵션을 사용하여 다른 로깅 수준을 선택할 수 있습니다. --통나무-
수평. 에 --조용한 모드에서만 치명적인 오류가 보고됩니다. 이러한 매우 심각한 오류 이벤트에서,
응용 프로그램은 일반적으로 종료됩니다. 다양한 로깅 수준에 대한 자세한 내용은
모듈 'oflog'의 문서를 참조하십시오.
로깅 출력을 파일에 기록해야 하는 경우(선택적으로 로그 파일 회전 포함),
syslog(Unix) 또는 이벤트 로그(Windows) 옵션 --로그 구성 사용할 수 있습니다. 이것
구성 파일은 또한 특정 메시지만 특정 출력으로 보낼 수 있습니다.
스트림 및 모듈 또는 애플리케이션을 기반으로 특정 메시지 필터링
생성됩니다. 예제 구성 파일은 다음에서 제공됩니다. /로거.cfg.

COMMAND LINE

모든 명령줄 도구는 매개변수에 대해 다음 표기법을 사용합니다.
선택적 값(0-1), 세 개의 후행 점은 여러 값이 허용됨을 나타냅니다.
(1-n), 둘의 조합은 0에서 n 값을 의미합니다.
명령줄 옵션은 선행 '+' 또는 '-' 기호로 매개변수와 구별됩니다.
각기. 일반적으로 명령줄 옵션의 순서와 위치는 임의적입니다(즉,
어디에나 나타날 수 있음). 그러나 옵션이 상호 배타적인 경우 가장 오른쪽 모양
사용. 이 동작은 일반적인 Unix 셸의 표준 평가 규칙을 따릅니다.
또한 '@' 기호를 접두사로 사용하여 하나 이상의 명령 파일을 지정할 수 있습니다.
파일 이름(예: @명령.txt). 이러한 명령 인수는 다음 내용으로 대체됩니다.
해당 텍스트 파일(여러 공백은
추가 평가 전에 두 개의 따옴표 사이에 나타납니다. 점에 유의하시기 바랍니다
명령 파일은 다른 명령 파일을 포함할 수 없습니다. 이 간단하지만 효과적인 접근 방식
옵션/매개변수의 일반적인 조합을 요약하고 길고
혼란스러운 명령줄(예는 파일 /dumppat.txt).

환경

XNUMXD덴탈의 img2dcm 유틸리티는 파일에 지정된 DICOM 데이터 사전을 로드하려고 시도합니다.
DCMDICT경로 환경 변수. 기본적으로, 즉 DCMDICT경로 환경 변수
설정되지 않은 파일 /dicom.dic 사전이 빌드되지 않으면 로드됩니다.
응용 프로그램에 추가합니다(Windows의 경우 기본값).
기본 동작이 선호되어야 하며 DCMDICT경로 환경 변수만
대체 데이터 사전이 필요할 때 사용됩니다. NS DCMDICT경로 환경 변수
유닉스 쉘과 같은 형식을 가짐 PATH 콜론(':')으로 구분되는 변수
항목. Windows 시스템에서는 세미콜론(';')이 구분 기호로 사용됩니다. 데이터 사전
코드는 지정된 각 파일을 로드하려고 시도합니다. DCMDICT경로 환경 변수. 그것
데이터 사전을 로드할 수 없는 경우 오류입니다.

onworks.net 서비스를 사용하여 온라인에서 img2dcm 사용