mincdump - מקוון בענן

תָכְנִית:

שֵׁם

mincdump - המרת קבצי minc לצורת ASCII (CDL)

תַקצִיר

mincdump [-c] [-h] [-v var1,...] [-ב lang] [-ו lang] [-ל לן] [-נ שם] [-עמ'
f_digits[,d_digits]] פילה

תיאור

mincdump מבוסס על הכלי netCDF ncdump, שונה לעבודה עם שני MINC 1 (netCDF)
וקבצי פורמט MINC 2 (HDF5). הוא מיועד לשימוש בעיקר עם סקריפטים כגון
mincdiff ו mincheader. מכיוון שהוא לא נוצר במכון הנוירולוגי של מונטריאול
הוא אינו תואם את המוסכמות הרגילות עבור תוכניות MINC.

mincdump יוצר ייצוג ASCII של קובץ minc שצוין בפלט סטנדרטי.
ייצוג ASCII הוא בצורה הנקראת CDL (``רשת Common Data form Language'')
שניתן לראות, לערוך או לשמש כקלט ncgen. ncgen היא תוכנית נלווית ש
יכול ליצור קובץ minc בינארי מקובץ CDL. לָכֵן ncgen ו mincdump יכול לשמש
הפוך כדי להפוך את ייצוג הנתונים בין ייצוגים בינאריים ל-ASCII.
לִרְאוֹת ncgen לתיאור של ייצוגי CDL ו-netCDF.

mincdump מגדיר פורמט ברירת מחדל המשמש עבור כל סוג של נתוני netCDF, אבל זה יכול להיות
שונה אם תכונת 'C_format' מוגדרת עבור משתנה netCDF. במקרה הזה,
mincdump ישתמש בתכונה 'C_format' כדי לעצב כל ערך. לדוגמה, אם
ידוע כי נתוני נקודה צפה עבור משתנה netCDF `Z' מדויקים לשלושה בלבד
ספרות משמעותיות, יהיה זה מתאים להשתמש בתכונת המשתנה

Z:C_format = "%3g"

mincdump עשוי לשמש גם כדפדפן פשוט עבור קבצי נתונים של netCDF, כדי להציג את
שמות וגדלים של מימדים; שמות, סוגים וצורות משתנים; שמות וערכים של תכונה;
ולחלופין, ערכי הנתונים עבור כל המשתנים או המשתנים שנבחרו ב-netCDF
קובץ.

mincdump משתמש ב-'_' כדי לייצג ערכי נתונים השווים לתכונה '_FillValue'
עבור משתנה, שנועד לייצג נתונים שטרם נכתבו. אם משתנה
אין תכונה '_FillValue', ערך המילוי המוגדר כברירת מחדל עבור סוג המשתנה משמש אם
המשתנה אינו מסוג בתים.

אפשרויות

-c הצג את הערכים של לתאם משתנים (משתנים שהם גם ממדים) as
כמו גם ההצהרות של כל הממדים, המשתנים וערכי התכונות. נתונים
ערכים של משתנים שאינם קואורדינטות אינם כלולים בפלט. זה
האפשרות המתאימה ביותר לשימוש לצורך מבט קצר על המבנה והתכולה של א
קובץ netCDF.

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

-v var1,...,varn
הפלט יכלול ערכי נתונים עבור המשתנים שצוינו, בנוסף ל-
הצהרות של כל הממדים, המשתנים והתכונות. משתנה אחד או יותר
יש לציין בשם ברשימה המופרדת בפסיקים לאחר אפשרות זו. ה
רשימה חייבת להיות ארגומנט בודד לפקודה, ולכן לא יכולה להכיל ריקים או אחרים
תווי רווח לבן. המשתנים בעלי השם חייבים להיות משתני netCDF חוקיים ב-
קובץ קלט. ברירת המחדל, ללא אפשרות זו ובהעדר ה -c or -h
אפשרויות, היא לכלול ערכי נתונים עבור את כל משתנים בפלט.

-b lang
הערה קצרה בצורה של הערת CDL (טקסט שמתחיל בתווים
``//'') ייכלל בקטע הנתונים של הפלט עבור כל `שורה' של נתונים,
כדי לסייע בזיהוי ערכי נתונים עבור משתנים רב-ממדיים. אם lang מתחיל עם
'C' או 'c', אז ייעשה שימוש במוסכמות שפת C (מדדים מבוססי אפס, אחרון
הממד משתנה הכי מהר). אם lang מתחיל ב-'F' או 'f', ולאחר מכן בשפת Fortran
ייעשה שימוש במוסכמות (מדדים מבוססי אחד, הממד הראשון משתנה הכי מהר). ב
בכל מקרה, הנתונים יוצגו באותו סדר; רק את ההערות
יהיה שונה. אפשרות זו שימושית לגלישה בנפחים גדולים של
נתונים רב מימדיים.

-f lang
הערות מלאות בצורה של הערות CDL נגררות (טקסט שמתחיל ב-
תווים ``//'') עבור כל ערך נתונים (למעט תווים בודדים בתווים
מערכים) ייכללו בסעיף הנתונים. אם lang מתחיל ב-'C' או 'c', אז
ייעשה שימוש במוסכמות של שפת C (מדדים מבוססי אפס, הממד האחרון משתנה
המהיר ביותר). אם lang מתחיל ב-'F' או 'f', ואז מוסכמות השפה של Fortran יהיו
להשתמש (מדדים מבוססי אחד, הממד הראשון משתנה הכי מהר). בכל מקרה, ה
הנתונים יוצגו באותו סדר; רק ההערות יהיו שונות. זֶה
האפשרות עשויה להיות שימושית עבור העברת נתונים לתוך מסננים אחרים, שכן כל ערך נתונים
מופיע בשורה נפרדת, מזוהה במלואה.

-l לן משנה את ברירת המחדל של אורך השורה המקסימלי (80) המשמש בעיצוב רשימות של לא-
ערכי נתוני תווים.

-n שם
CDL דורש שם עבור מערך נתונים netCDF, לשימוש על ידי ncgen -b ביצירת א
ברירת המחדל של שם קובץ netCDF. כברירת מחדל, mincdump בונה את השם הזה מהקודם
רכיב של שם הנתיב של קובץ הקלט netCDF על ידי ביטול כל סיומת
יש לזה. להשתמש ב -n אפשרות לציין שם אחר. למרות קובץ הפלט
שם בשימוש על ידי ncgen -b ניתן לפרט, ייתכן שיהיה חכם mincdump לשנות את ה
שם ברירת מחדל כדי להימנע מהחלפה בטעות של קובץ netCDF בעל ערך בעת השימוש
mincdump, עריכת קובץ ה-CDL שהתקבל, ושימוש ncgen -b כדי ליצור חדש
קובץ netCDF מקובץ ה-CDL הערוך.

-p ספרות_צפות[,ספרות_כפולות]
מציין דיוק ברירת מחדל (מספר ספרות משמעותיות) לשימוש בתצוגה
ערכי נתונים של נקודה צפה או דיוק כפול עבור תכונות ומשתנים. אם
שצוין, ערך זה עוקף את הערך של תכונת 'C_format' עבור כל אחד
משתנה שיש לו תכונה כזו. נתוני נקודה צפה יוצגו עם
ספרות_צפות ספרות משמעותיות. אם ספרות כפולות מצוין גם, כפול
ערכי דיוק יוצגו עם כל כך הרבה ספרות משמעותיות. בתוך ה
היעדר כל -p מפרטים, נתוני נקודה צפה ודיוק כפול הם
מוצג עם 7 ו-15 ספרות משמעותיות בהתאמה. ניתן ליצור קבצי CDL
קטן יותר אם נדרש פחות דיוק. אם גם נקודה צפה וגם לחץ כפול
דיוקים מצוינים, שני הערכים חייבים להופיע מופרדים בפסיק (לא
ריקים) כארגומנט יחיד לפקודה. אם אתה באמת רוצה כל קטע אחרון
דיוק מקובץ netCDF המיוצג בקובץ CDL לכל האפשר
ערכי נקודה צפה, תצטרך לציין זאת עם -p 9,17 (לפי
משפט 15 של המאמר המופיע תחת הפניות).

דוגמאות

תסתכל על מבנה הנתונים בקובץ netCDF `foo.mnc':

mincdump -c foo.mnc

הפק גרסת CDL מוערת של המבנה והנתונים בקובץ netCDF `foo.mnc',
שימוש באינדקס בסגנון C עבור ההערות:

mincdump -bc foo.mnc > foo.cdl

פלט נתונים עבור המשתנים `uwind' ו-`vwind' בלבד מקובץ netCDF `foo.mnc', ו
הצג את נתוני הנקודה הצפה עם שלוש ספרות משמעותיות בלבד של דיוק:

mincdump -v uwind,vwind -p 3 foo.mnc

צור רישום מלא עם הערות (ערך נתונים אחד בכל שורה) של הנתונים עבור המשתנה
`omega', שימוש במוסכמות Fortran עבור מדדים, ושינוי שם הנתונים של netCDF ב
קובץ ה-CDL שהתקבל ל-'omega':

mincdump -v אומגה -f fortran -n אומגה foo.mnc > Z.cdl

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