mincgen - מקוון בענן

תָכְנִית:

שֵׁם

mincgen - צור קובץ MINC מקובץ CDL.

תַקצִיר

mincgen [-b] [-n] [-o minc_filename] input_file

תיאור

mincgen יוצר קובץ MINC. הקלט ל mincgen הוא תיאור של קובץ MINC ב-a
שפה קטנה הידועה בשם CDL (רשת Common Data form Language), המתוארת להלן. אם לא
האפשרויות מצוינות בהפעלת mincgen, הוא רק בודק את התחביר של CDL הקלט
קובץ, תוך הפקת הודעות שגיאה עבור כל הפרה של תחביר CDL. אפשרויות אחרות יכולות להיות
משמש ליצירת קובץ ה-MINC המתאים.

mincgen ניתן להשתמש עם התוכנית הנלווית mincdump לבצע כמה פעולות פשוטות
על קבצי MINC. לדוגמה, כדי לשנות שם של ממד בקובץ MINC, השתמש mincdump כדי לקבל
גרסת CDL של קובץ ה-MINC, ערוך את קובץ ה-CDL כדי לשנות את שם המידות, וכן
להשתמש mincgen כדי ליצור את קובץ ה-MINC המתאים מקובץ ה-CDL הערוך.

אפשרויות

-b צור קובץ MINC (בינארי). אם ה -o האפשרות נעדרת, שם קובץ ברירת מחדל יהיה
להיות בנוי מהשם MINC (מצוין אחרי ה netcdf or hdf5 מילת מפתח ב
הקלט) על ידי הוספת הסיומת '.mnc'. אם כבר קיים קובץ עם
השם שצוין, הוא יוחלף.

-o minc_filename
שם לקובץ ה-MINC הבינארי שנוצר. אם אפשרות זו מצוינת, היא מרמזת על
"-bאפשרות זו נחוצה מכיוון שלא ניתן לכתוב קבצי MINC
ישירות לפלט סטנדרטי, מכיוון שלא ניתן לחפש פלט סטנדרטי.)

דוגמאות

בדוק את התחביר של קובץ ה-CDL `foo.cdl':

mincgen foo.cdl

מקובץ CDL `foo.cdl', צור קובץ MINC בינארי שווה ערך בשם `x.mnc':

mincgen -o x.mnc foo.cdl

נוהג

CDL תחביר <br> סיכום
להלן דוגמה לתחביר CDL, המתאר קובץ MINC עם מספר ממדים בעלי שם
(xspace, yspace ו-zspace), משתנים (zspace, image), תכונות משתנים (valid_range,
signtype), וכמה נתונים. מילות מפתח של CDL מודגשות. (דוגמה זו מיועדת
להמחיש את התחביר; לקובץ CDL אמיתי יהיה קבוצה שלמה יותר של תכונות כך
שהנתונים יתארו את עצמם בצורה מלאה יותר.)

netcdf foo { // מפרט MINC לדוגמה ב-CDL

ממדים:
xspace = 8;
yspace = 8;
zspace = 5;

משתנים:
לצוף xspace;
לצוף yspace;
לצוף zspace(zspace);
קצר image(zspace,yspace,xspace);
לְהַכפִּיל image-min(zspace)
לְהַכפִּיל image-max(zspace)

// תכונות משתנות
image:valid_range = 0,5;
נתונים:
image-min = -1,-1,-1,-1,-1;
image-max = 1,1,1,1,1;
תמונה =
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5;
zspace = 0,2,3.5,7,10;
}

כל הצהרות CDL מסתיימות על ידי נקודה-פסיק. ניתן להשתמש ברווחים, בטאבים ובשורות חדשות
באופן חופשי לקריאות. הערות עשויות לעקוב אחר התווים `//' בכל שורה.

תיאור CDL מורכב משלושה חלקים אופציונליים: ממדים, משתנים, ו נתונים,
מתחיל במילת המפתח ממדים:, משתנים:, ו נתונים, בהתאמה. המשתנה
חלק עשוי להכיל משתנה הצהרות ו תכונה הקצאות.

MINC ממד משמש להגדרת הצורה של אחד או יותר מהרב-ממדיים
משתנים הכלולים בקובץ MINC. לממד MINC יש שם, גודל ואולי
כמה תכונות אחרות.

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

רשת CDF תכונה מכיל מידע על משתנה netCDF או על כל netCDF
מערך נתונים. תכונות משמשות לציון מאפיינים כגון יחידות, ערכים מיוחדים, מקסימום
וערכים מינימליים חוקיים, גורמי קנה מידה, קיזוזים ופרמטרים. מידע על תכונה
מיוצג על ידי ערכים בודדים או מערכים של ערכים. לדוגמה, "יחידות" היא תכונה
מיוצג על ידי מערך תווים כגון "צלזיוס". לתכונה יש משויך
משתנה, שם, סוג נתונים, אורך וערך. בניגוד למשתנים שכן
מיועדים לנתונים, תכונות מיועדות למטא נתונים (נתונים על נתונים).

ב-CDL, תכונה מסומנת על ידי משתנה ושם תכונה, מופרדים על ידי `:'. זה
אפשרי להקצות גלוֹבָּלִי תכונות שאינן משויכות לשום משתנה לקובץ בתור א
שלם באמצעות `:' לפני שם התכונה. סוג הנתונים של תכונה ב-CDL הוא
נגזר מסוג הערך שהוקצה לו. האורך של תכונה הוא ה-
מספר ערכי הנתונים שהוקצו לו, או מספר התווים במחרוזת התווים
מוקצה לו. ערכים מרובים מוקצים לתכונות שאינן תוויות על ידי הפרדה
הערכים עם פסיקים. כל הערכים המוקצים לתכונה חייבים להיות מאותו סוג.

השמות של ממדי CDL, משתנים ותכונות חייבים להתחיל באלפביתי
תו או `_', והתווים הבאים עשויים להיות אלפאנומריים או `_' או `-'.

האופציונלי נתונים קטע של מפרט CDL הוא המקום בו ניתן לאתחל משתנים.
התחביר של אתחול הוא פשוט: שם משתנה, סימן שוויון ופסיק-
רשימה מופרדת של קבועים (אולי מופרדים על ידי רווחים, טאבים ושורות חדשות) הסתיימה
עם נקודה-פסיק. עבור מערכים רב-ממדיים, הממד האחרון משתנה הכי מהר. לכן
סדר שורות ולא סדר עמודות משמש עבור מטריצות. אם יסופקו פחות ערכים
ממה שצריך כדי למלא משתנה, הוא מורחב עם `ערך מילוי' תלוי סוג,
אשר ניתן לעקוף על ידי אספקת ערך עבור תכונת משתנה מובחן בשם
`_FillValue'. סוגי הקבועים אינם צריכים להתאים לסוג המוצהר עבור משתנה;
כפיות נעשות כדי להמיר מספרים שלמים לנקודה צפה, למשל. הקבוע `_'
ניתן להשתמש כדי לייעד את ערך המילוי עבור משתנה.

פרימיטיבי נתונים סוגים
char תווים
בייט נתוני 8 סיביות
קצר מספרים שלמים עם סימנים של 16 סיביות
ארוך מספרים שלמים עם סימנים של 32 סיביות
int (שם נרדף ל ארוך)
לצוף IEEE נקודה צפה יחידה דיוק (32 סיביות)
ממשי (שם נרדף ל לצוף)
לְהַכפִּיל IEEE נקודה צפה דיוק כפולה (64 סיביות)

פרט לסוג הנתונים שנוסף בייט והחוסר של לא חתום, CDL תומך באותו
סוגי נתונים פרימיטיביים כ-C. השמות של סוגי הנתונים הפרימיטיביים הם מילים שמורות ב
CDL, כך ששמות המשתנים, הממדים והתכונות אינם חייבים להיות שמות טיפוסים. ב
הצהרות, ניתן לציין שמות סוגים באותיות גדולות או קטנות.

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

מכנסיים קצרים יכולים להחזיק ערכים בין -32768 ל-32767.

Longs יכול להחזיק ערכים בין -2147483648 ל-2147483647. int ו מספר שלם מתקבלים כ
מילים נרדפות ל ארוך בהצהרות CDL. עכשיו שיש פלטפורמות עם 64 סיביות
ייצוגים עבור C longs, אולי עדיף להשתמש ב- int מילה נרדפת כדי למנוע בלבול.

צפים יכולים להחזיק ערכים בין כ-3.4+38 ל-3.4+38. הייצוג החיצוני שלהם הוא
כמו 32-bit IEEE מנורמל מספרי נקודה צפה עם דיוק יחיד. ממשי מתקבל בתור א
מילה נרדפת ל לצוף בהצהרות CDL.

כפולים יכולים להחזיק ערכים בין כ-1.7+308 ל-1.7+308. הייצוג החיצוני שלהם
הוא כ-64 סיביות IEEE מנורמל מספרי נקודה צפה עם דיוק כפול.

CDL קבועים
קבועים המוקצים לתכונות או למשתנים עשויים להיות מכל אחד מסוגי ה-MINC הבסיסיים. ה
תחביר עבור קבועים דומה לתחביר C, אלא שיש לצרף סיומות סוג ל
מכנסיים קצרים ומצופים כדי להבדיל אותם מלונגים וכפולים.

A בייט קבוע מיוצג על ידי רצף בריחה של תו בודד או מספר תווים
מוקף במרכאות בודדות. לדוגמה,
'a' // ASCII 'a'
'\0' // בית אפס
'\n' // תו ASCII newline
'\33' // תו Escape ASCII (33 אוקטלי)
'\x2b' // ASCII plus (2b hex)
'\377' // 377 אוקטלי = 255 עשרוני, ללא ASCII

קבועי תווים מוקפים במירכאות כפולות. מערך תווים עשוי להיות מיוצג
כמחרוזת המוקפת במירכאות כפולות. מוסכמות הבריחה הרגילות של מחרוזת C זוכות לכבוד.
לדוגמה
"a" // ASCII `a'
"שתי\nשורות\n" // מחרוזת בת 10 תווים עם שתי שורות חדשות מוטבעות
"a bell:\007" // מחרוזת המכילה פעמון ASCII
שימו לב שמערך התווים "a" יתאים למשתנה בעל אלמנט אחד, שכן לא
ההנחה היא תו NULL המסתיים. עם זאת, בית אפס במערך תווים כן
מתפרש כסוף הדמויות המשמעותיות על ידי ה mincdump תוכנית, בעקבות
אמנה C. לכן, אין להטמיע בייט NULL במחרוזת תווים
אלא אם כן בסוף: השתמש ב- בייט סוג נתונים במקום עבור מערכי בתים המכילים את האפס
בייט. ל-MINC ול-CDL אין סוג מחרוזת, אלא רק מערכי תווים באורך קבוע, שיכולים
להיות רב מימדיים.

קצר קבועים שלמים נועדו לייצוג כמויות בסימן של 16 סיביות. הצורה
של קצר קבוע הוא קבוע של מספר שלם עם 's' או 'S' מצורף. אם קצר
הקבוע מתחיל ב-'0', הוא מתפרש כאוקטלי, אלא שאם הוא מתחיל ב-'0x',
הוא מתפרש כקבוע הקסדצימלי. לדוגמה:
-2s // קצר -2
0123s // אוקטל
0x7ffs //הקסדצימלי

ארוך קבועים שלמים נועדו לייצוג כמויות בסימן של 32 סיביות. הצורה
של ארוך קבוע הוא קבוע מספר שלם רגיל, אם כי מקובל להוסיף an
'l' או 'L' אופציונליים. אם ארוך הקבוע מתחיל ב-0, הוא מתפרש כאוקטלי,
אלא שאם הוא מתחיל ב-'0x', הוא מתפרש כקבוע הקסדצימלי. דוגמאות
של תקף ארוך הקבועים כוללים:
-2
1234567890L
0123 // אוקטאל
0x7ff // הקסדצימלי

קבועי נקודה צפה מסוג לצוף מתאימים לייצוג נקודה צפה
נתונים עם כשבע ספרות משמעותיות של דיוק. הצורה של א לצוף קבוע הוא
זהה לקבוע נקודה צפה C עם 'f' או 'F' מצורף. למשל ה
הבאים כולם מקובלים לצוף קבועים:
-2.0ו
3.14159265358979f // יקוצץ בפחות דיוק
1. f

קבועי נקודה צפה מסוג לְהַכפִּיל מתאימים לייצוג נקודה צפה
נתונים עם כשש עשרה ספרות משמעותיות של דיוק. הצורה של א לְהַכפִּיל קבוע הוא
זהה לקבוע נקודה צפה C. ניתן להוסיף 'd' או 'D' אופציונליים. ל
לדוגמה, כולם מקובלים לְהַכפִּיל קבועים:
-2.0
3.141592653589793
1.0e-20
1. ד

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