xml2dcm - מקוון בענן

תָכְנִית:

שֵׁם

xml2dcm - המרת מסמך XML לקובץ DICOM או לסט נתונים

תַקצִיר

xml2dcm [אפשרויות] xmlfile-in dcmfile-out

תיאור

אל האני xml2dcm כלי השירות ממיר את התוכן של מסמך XML (שפת סימון הרחבה).
לקובץ DICOM או לסט נתונים. מסמך ה-XML צפוי לאמת מול ה-DTD
(הגדרת סוג מסמך) המתוארת בקובץ dcm2xml.dtd. קובץ XML מתאים
ניתן ליצור באמצעות dcm2xml כלי (אפשרות +Wb מומלץ לכלול נתונים בינאריים).

פרמטרים

xmlfile-in שם קובץ קלט XML להמרה (stdin: "-")

dcmfile-out שם קובץ פלט DICOM

אפשרויות

כללי אפשרויות
-h --עזרה
הדפס את טקסט העזרה הזה וצא

--גִרְסָה
הדפס מידע על גרסה ויציאה

--טיעונים
הדפס ארגומנטים מורחבים של שורת פקודה

-q --שקט
מצב שקט, ללא אזהרות ושגיאות

-v --מלל
מצב מילולי, פרטי עיבוד הדפסה

-d --debug
מצב ניפוי באגים, הדפס מידע על ניפוי באגים

-ll --log-level [l]evel: קבוע מחרוזת
(פטאלי, שגיאה, אזהרה, מידע, איתור באגים, מעקב)
השתמש ברמה l עבור לוגר

-lc --log-config [f]שם קובץ: מחרוזת
השתמש בקובץ התצורה f עבור לוגר

קלט אפשרויות
פורמט קובץ קלט:

+f --read-meta-info
קרא מידע מטא אם קיים (ברירת מחדל)

-f --התעלם-מטא-מידע
התעלם ממידע מטא של קובץ

תהליך אפשרויות
מַתַן תוֹקֵף:

+Vd --validate-document
לאמת מסמך XML מול DTD

+Vn --check-namespace
בדוק את מרחב השמות של XML בשורש המסמך

מזהים ייחודיים:

+Ug --generate-new-uids
ליצור UID חדש של מחקר/סדרה/SOP

-Uo --dont-overwrite-uids
אל תחליף מזהי UID קיימים (ברירת מחדל)

+Uo --overwrite-uids
לדרוס מזהי UID קיימים

תפוקה אפשרויות
פורמט קובץ פלט:

+F --כתוב-קובץ
כתוב פורמט קובץ (ברירת מחדל)

-F --write-dataset
כתוב סט נתונים ללא מטא מידע על הקובץ

+Fu --update-meta-info
לעדכן מטא מידע קובץ מסוים

תחביר העברת פלט:

+t= --write-xfer-same
כתוב עם אותו TS כמו קלט (ברירת מחדל)

+te --write-xfer-little
כתוב עם VR מפורש little endian TS

+tb --write-xfer-big
כתוב עם VR מפורש ביג אנדיאן TS

+ti --write-xfer-implicit
כתוב עם VR מרומז little endian TS

+td --write-xfer-deflated
כתוב עם VR מפורש מפורש קטן אנדיאן TS

ייצוגי ערכים שלאחר 1993:

+u --enable-new-vr
אפשר תמיכה עבור VRs חדשים (UN/UT) (ברירת מחדל)

-u --disable-new-vr
השבת את התמיכה עבור VRs חדשים, המר ל-OB

קידוד אורך קבוצה:

+g= --group-length-recalc
חשב מחדש אורכי קבוצה אם קיימים (ברירת מחדל)

+g --קבוצה-אורך-צור
תמיד לכתוב עם אלמנטים של אורך קבוצה

-g --קבוצה-אורך-הסר
כתוב תמיד ללא רכיבי אורך קבוצה

קידוד אורך ברצפים ופריטים:

+e --אורך-מפורש
כתוב באורך מפורש (ברירת מחדל)

-e --אורך-לא מוגדר
לכתוב באורך לא מוגדר

ריפוד נגרר של ערכת נתונים (לא עם --write-dataset):

-p= --padding-retain
אל תשנה ריפוד (ברירת מחדל אם לא --write-dataset)

-p --padding-off
ללא ריפוד (מרומז אם --write-dataset)

+p --padding-create [f]ile-pad [i]tem-pad: מספר שלם
יישר קובץ על מספר f בתים ופריטים על
כפולה של i bytes

הורדת רמת הדחיסה (רק עם --write-xfer-deflated):

+cl --רמת דחיסה [l]רמה: מספר שלם (ברירת מחדל: 6)
0=לא דחוס, 1=המהירות ביותר, 9=הדחיסה הטובה ביותר

אורים

המבנה הבסיסי של קלט ה-XML הצפוי נראה כך:



<file-format xmlns="http://dicom.offis.de/dcmtk">

<element tag="0002,0000" vr="UL" vm="1" len="4"
name="MetaElementGroupLength">
166

...
<element tag="0002,0013" vr="SH" vm="1" len="16"
name="ImplementationVersionName">
OFFIS_DCMTK_353



<element tag="0008,0005" vr="CS" vm="1" len="10"
name="SpecificCharacterSet">
ISO_IR 100

...


<element tag="0028,3002" vr="xs" vm="3" len="6"
name="LUTDescriptor">
256 \ 0 \ 8

...

...

...
<element tag="7fe0,0010" vr="OW" vm="1" len="262144"
name="PixelData" loaded="no" binary="hidden">




התגים 'פורמט קובץ' ו-'מטה-כותרת' עשויים להיעדר עבור ערכות נתונים של DICOM.

אופי קידוד
קידוד התווים של DICOM נקבע אוטומטית מהאלמנט עם התג
'0008,0005' (סט תווים ספציפי) - אם קיים. ערכות התווים הבאות הן
נתמך כרגע (דורש libxml לכלול סמל תמיכה, ראה --גִרְסָה תְפוּקָה):

ASCII (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO Latin 1 "ISO_IR 100" (ISO-8859-1)
ISO Latin 2 "ISO_IR 101" (ISO-8859-2)
ISO Latin 3 "ISO_IR 109" (ISO-8859-3)
ISO Latin 4 "ISO_IR 110" (ISO-8859-4)
ISO Latin 5 "ISO_IR 148" (ISO-8859-9)
קירילי "ISO_IR 144" (ISO-8859-5)
ערבית "ISO_IR 127" (ISO-8859-6)
"ISO_IR 126" יוונית (ISO-8859-7)
עברית "ISO_IR 138" (ISO-8859-8)

קבוצות תווים מרובות אינן נתמכות (רק הערך הראשון של 'תו ספציפי
Set' משמש עבור קידוד התווים במקרה של ריבוי ערכים).

לִרְאוֹת dcm2xml תיעוד לפרטים נוספים על מבנה ה-XML.

בינרי נתונים
ניתן לקודד נתונים בינאריים כרצף של מספרי hex מופרדים באמצעות קו נטוי אחורי
'\' או בפורמט Base64 (binary='base64'). בנוסף, ניתן לקרוא גם נתונים בינאריים
קובץ (binary='file'). במקרה זה, יש לציין את שם הקובץ כערך האלמנט,
לְמָשָׁל

subdir/pixeldata.raw

שימו לב שתוכן הקובץ ייקרא כפי שהוא. נתוני OW צפויים להיות
little endian הוזמן ויוחלף במידת הצורך. לא יבוצעו בדיקות לוודא
שכמות הנתונים סבירה במונחים של תכונות אחרות כגון Rows או
עמודות.

דְחִיסָה
אם libxml מורכב עם תמיכת zlib, קובץ הקלט (xmlfile-in) יכול להיות גם
דחוס עם ZIP, מה שבדרך כלל מביא לקבצים קטנים בהרבה. ראה פלט של אפשרות
--גִרְסָה על מנת לבדוק אם תמיכת zlib זמינה.

מגבלות
לגירסאות שונות של libxml עשויות להיות מגבלות שונות עבור האורך המרבי של XML
ערך אלמנט. לכן, יש להימנע משימוש בערכי אלמנט ארוכים מאוד (למשל עבור
נתוני פיקסל).

שים לב ש xml2dcm כרגע אינו תומך באופן מלא בקבצי DICOMDIR. במיוחד,
הערך של רכיבי נתוני ההיסט השונים אינו מתעדכן אוטומטית על ידי כלי זה.

יומן

רמת פלט הרישום של כלי שורת הפקודה השונים והספריות הבסיסיות יכולה
יצוין על ידי המשתמש. כברירת מחדל, רק שגיאות ואזהרות נכתבות לתקן
זרם שגיאות. שימוש באפשרות --מִלוּלִי גם הודעות מידע כמו עיבוד פרטים
דווחו. אוֹפְּצִיָה --לנפות ניתן להשתמש כדי לקבל פרטים נוספים על הפעילות הפנימית,
למשל למטרות ניפוי באגים. ניתן לבחור רמות רישום אחרות באמצעות האפשרות --עֵץ-
רָמָה. ב --שֶׁקֶט במצב רק שגיאות קטלניות מדווחות. באירועי שגיאה כה חמורים,
הבקשה תסתיים בדרך כלל. לפרטים נוספים על רמות הרישום השונות,
ראה תיעוד של מודול 'oflog'.

במקרה שיש לכתוב את פלט הרישום לקובץ (אופציונלי עם סיבוב קובץ יומן),
ל-syslog (Unix) או לאפשרות יומן האירועים (Windows). --log-config יכול לשמש. זֶה
קובץ התצורה מאפשר גם להפנות רק הודעות מסוימות לפלט מסוים
זרם ולסינון הודעות מסוימות בהתבסס על המודול או היישום שבו הם
נוצרים. קובץ תצורה לדוגמה מסופק ב /logger.cfg.

פקודה קו

כל כלי שורת הפקודה משתמשים בסימון הבא עבור פרמטרים: סוגריים מרובעים מקיפים
ערכים אופציונליים (0-1), שלוש נקודות עוקבות מצביעות על כך שמתירים מספר ערכים
(1-n), שילוב של שניהם פירושו 0 עד n ערכים.

אפשרויות שורת הפקודה מובדלות מפרמטרים על ידי סימן '+' או '-' מוביל,
בהתאמה. בדרך כלל, הסדר והמיקום של אפשרויות שורת הפקודה הם שרירותיים (כלומר
יכול להופיע בכל מקום). עם זאת, אם האפשרויות סותרות זו את זו, המראה הימני ביותר
משמש. התנהגות זו תואמת את כללי ההערכה הסטנדרטיים של קונכיות Unix נפוצות.

בנוסף, ניתן לציין קובץ פקודה אחד או יותר באמצעות סימן '@' כתחילית ל
שם הקובץ (למשל @command.txt). ארגומנט פקודה כזה מוחלף בתוכן של
קובץ הטקסט המתאים (ריבוי רווחים מרובים מטופלים כמפריד יחיד אלא אם כן
הם מופיעים בין שתי מרכאות) לפני כל הערכה נוספת. שים לב ש
קובץ פקודה לא יכול להכיל קובץ פקודה אחר. גישה פשוטה אך יעילה זו
מאפשר לסכם שילובים נפוצים של אפשרויות/פרמטרים ונמנע ארוך ו
שורות פקודה מבלבלות (דוגמה מסופקת בקובץ /dumppat.txt).

הסביבה

אל האני xml2dcm כלי השירות ינסה לטעון את מילוני הנתונים של DICOM המצוינים ב-
DCDICTPATH משתנה הסביבה. כברירת מחדל, כלומר אם DCDICTPATH משתנה הסביבה
לא מוגדר, הקובץ /dicom.dic ייטען אלא אם המילון נבנה
לתוך האפליקציה (ברירת מחדל עבור Windows).

יש להעדיף את התנהגות ברירת המחדל ואת DCDICTPATH משתנה סביבה בלבד
משמש כאשר נדרשים מילוני נתונים חלופיים. ה DCDICTPATH משתנה הסביבה
יש אותו פורמט כמו מעטפת יוניקס נתיב משתנה בכך שנקודתיים (':') מפריד
ערכים. במערכות Windows, נקודה-פסיק (';') משמשת כמפריד. מילון הנתונים
הקוד ינסה לטעון כל קובץ שצוין ב- DCDICTPATH משתנה הסביבה. זה
היא שגיאה אם ​​לא ניתן לטעון מילון נתונים.

השתמש ב-xml2dcm באינטרנט באמצעות שירותי onworks.net