mincgen - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

mincgen - Створення файлу MINC з файлу CDL.

СИНТАКСИС

mincgen [-b] [-n] [-o minc_ім'я_файлу] вхідний_файл

ОПИС

mincgen створює файл MINC. Вхід до mincgen є описом файлу MINC в a
невелика мова, відома як CDL (Network 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_ім'я_файлу
Ім'я для створеного двійкового файлу MINC. Якщо цей параметр вказано, це означає, що
"-b". (Цей параметр необхідний, оскільки файли MINC не можна записати
безпосередньо до стандартного виводу, оскільки стандартний вихід не шукати.)

ПРИКЛАДИ

Перевірте синтаксис файлу CDL `foo.cdl':

mincgen foo.cdl

З файлу CDL `foo.cdl', згенеруйте еквівалентний двійковий файл MINC з іменем `x.mnc':

mincgen -o x.mnc foo.cdl

ВИКОРИСТАННЯ

CDL синтаксис Підсумки
Нижче наведено приклад синтаксису CDL, що описує файл MINC з кількома названими вимірами
(xspace, yspace і zspace), змінні (zspace, image), атрибути змінних (valid_range,
signtype) та деякі дані. Ключові слова CDL виділені жирним шрифтом. (Цей приклад призначений для
проілюструвати синтаксис; Справжній файл CDL мав би більш повний набір атрибутів
що дані будуть більш повно самоописуваними.)

netcdf foo { // приклад специфікації MINC у CDL

розміри:
xпробіл = 8;
yпробіл = 8;
zпробіл = 5;

змінні:
плавати xspace;
плавати yspace;
плавати zspace(zspace);
коротка зображення (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;
zпробіл = 0,2,3.5,7,10;
}

Усі оператори CDL закінчуються крапкою з комою. Можна використовувати пробіли, табуляції та нові рядки
вільно для читабельності. Коментарі можуть слідувати за символами `//' в будь-якому рядку.

Опис CDL складається з трьох необов'язкових частин: розміри, змінні та дані,
починаючи з ключового слова розміри:, змінні: та дані, відповідно. Змінна
частина може містити змінна декларацій та атрибут Призначення.

MINC вимір використовується для визначення форми одного або кількох багатовимірних
змінні, що містяться у файлі MINC. Вимір MINC має назву, розмір і можливо
кілька інших атрибутів.

A змінна представляє багатовимірний масив значень одного типу. Змінна має
ім'я, тип даних і фігура, описані її списком розмірів. Кожна змінна може
також пов’язані Атрибути (див. нижче), а також значення даних. Ім'я, тип даних,
і форма змінної визначаються її оголошенням у файлі змінна розділ CDL
опис. Змінна може мати те саме ім'я, що й вимір; за домовленістю таке
змінна є одновимірною і містить координати розміру, який вона називає.
Розміри не повинні мати відповідних змінних.

netCDF атрибут містить інформацію про змінну netCDF або про весь netCDF
набір даних. Атрибути використовуються для визначення таких властивостей, як одиниці, спеціальні значення, максимум
і мінімально допустимі значення, коефіцієнти масштабування, зміщення та параметри. Інформація про атрибути
представлений окремими значеннями або масивами значень. Наприклад, «одиниці» є атрибутом
представлений символьним масивом, таким як "celsius". Атрибут має асоційований
змінна, ім'я, тип даних, довжина та значення. На відміну від змінних, які є
призначені для даних, атрибути призначені для метаданих (даних про дані).

У CDL атрибут позначається змінною та ім'ям атрибута, розділених символом `:'. Це
можна призначити в цілому атрибути, не пов’язані з жодною змінною до файлу як a
цілком, використовуючи `:' перед назвою атрибута. Тип даних атрибута в CDL
походить від типу присвоєного йому значення. Довжина атрибута
кількість значень даних, присвоєних йому, або кількість символів у рядку символів
призначений до нього. Кілька значень присвоюються не символьним атрибутам шляхом розділення
значення з комами. Усі значення, призначені атрибуту, мають бути одного типу.

Назви параметрів, змінних та атрибутів CDL мають починатися з алфавіту
символ або "_", а наступні символи можуть бути буквено-цифровими або "_" або "-".

The optional дані розділ специфікації CDL, де змінні можуть бути ініціалізовані.
Синтаксис ініціалізації простий: ім’я змінної, знак рівності та кома.
розмежований список констант (можливо, розділених пробілами, табуляціями та новими рядками) завершується
з крапкою з комою. Для багатовимірних масивів останній вимір змінюється найшвидше. Таким чином
Для матриць використовується порядок рядків, а не порядок стовпців. Якщо вказано менше значень
ніж потрібно для заповнення змінної, вона розширюється за допомогою типу, що залежить від "значення заповнення",
який можна замінити, вказавши значення для атрибута вирізняється змінної з назвою
`_FillValue'. Типи констант не повинні відповідати типу, оголошеному для змінної;
наприклад, для перетворення цілих чисел у з плаваючою комою виконуються примуси. Константа `_'
можна використовувати для визначення значення заповнення для змінної.

примітив дані типи
бак символи
байт 8-бітові дані
коротка 16-розрядні цілі числа зі знаком
довго 32-розрядні цілі числа зі знаком
Int (синонім до довго)
плавати IEEE з плаваючою комою з одинарною точністю (32 біти)
реальний (синонім до плавати)
подвійний IEEE з плаваючою комою подвійної точності (64 біта)

За винятком доданого типу даних байт та відсутність непідписаний, CDL підтримує те саме
примітивні типи даних як C. Імена для примітивних типів даних є зарезервованими словами в
CDL, тому імена змінних, вимірів та атрибутів не повинні бути іменами типів. в
оголошення, назви типів можуть бути вказані як у верхньому, так і в нижньому регістрі.

Байти відрізняються від символів тим, що вони призначені для зберігання повних восьми біт даних,
і нульовий байт не має особливого значення, як для символьних даних.

Шорти можуть містити значення від -32768 до 32767.

Довги можуть утримувати значення від -2147483648 до 2147483647. Int та ціле приймаються як
синоніми до довго в деклараціях CDL. Тепер є платформи з 64-розрядними
представлення для C longs, можливо, краще використовувати Int синонім, щоб уникнути плутанини.

Поплавки можуть утримувати значення приблизно від -3.4+38 до 3.4+38. Їхнє зовнішнє представництво є
як 32-бітові нормовані числа з плаваючою комою одинарної точності IEEE. реальний приймається як a
синонім до плавати в деклараціях CDL.

Подвійне значення може містити приблизно від -1.7+308 до 1.7+308. Їхнє зовнішнє уявлення
є стандартизованими числами з плаваючою комою з подвійною точністю 64-бітного стандарту IEEE.

CDL Константи
Константи, призначені атрибутам або змінним, можуть бути будь-якого з основних типів MINC. The
Синтаксис для констант подібний до синтаксису C, за винятком того, що до нього повинні бути додані суфікси типу
шорти та плавки, щоб відрізнити їх від довгих та двойних.

A байт константа представлена ​​одним символом або кількома символьною escape-послідовністю
укладені в одинарні лапки. Наприклад,
'a' // ASCII `a'
'\0' // нульовий байт
'\n' // символ нового рядка ASCII
'\33' // escape-символ ASCII (33 вісімковий)
'\x2b' // ASCII плюс (2b шістнадцятковий)
'\377' // 377 вісімкове число = 255 десяткових, не ASCII

Символьні константи беруться в подвійні лапки. Може бути представлений символьний масив
як рядок, узятий у подвійні лапки. Дотримуються звичайні угоди про вихід рядка C.
Наприклад
"a" // ASCII `a'
"Два\nрядки\n" // рядок із 10 символів із двома вбудованими новими рядками
"a bell:\007" // рядок, що містить дзвінок ASCII
Зауважте, що масив символів "a" вписується в одноелементну змінну, оскільки немає
передбачається кінцевий символ NULL. Однак нульовий байт у символьному масиві є
трактується як закінчення значущих персонажів mincdump програма, наступна
конвенція C. Отже, нульовий байт не повинен бути вбудований в рядок символів
якщо тільки в кінці: використовуйте байт замість типу даних для байтових масивів, які містять нуль
байт. 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.0f
3.14159265358979f // буде скорочено до меншої точності
1.f

Константи типу з плаваючою комою подвійний підходять для представлення з плаваючою комою
дані з приблизно шістнадцятьма значущими цифрами точності. Форма а подвійний константа є
те саме, що константа з плаваючою комою. Додатково може бути додано "d" або "D". Для
Наприклад, всі наступні є прийнятними подвійний константи:
-2.0
3.141592653589793
1.0е-20
1.г

Використовуйте mincgen онлайн за допомогою служб onworks.net