mincgen - Интернет в облаке

ПРОГРАММА:

ИМЯ

mincgen - создать файл MINC из файла CDL.

СИНТАКСИС

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

ОПИСАНИЕ

Минкген генерирует файл MINC. Вход в Минкген это описание файла MINC в
небольшой язык, известный как CDL (Network Common Data form Language), описанный ниже. Если нет
параметры указываются при вызове Минкген, он просто проверяет синтаксис входного CDL
файл, выдающий сообщения об ошибках для любых нарушений синтаксиса CDL. Другие варианты могут быть
используется для создания соответствующего файла MINC.

Минкген можно использовать с сопутствующей программой минкдамп выполнить несколько простых операций
в файлах MINC. Например, чтобы переименовать измерение в файле MINC, используйте минкдамп чтобы получить
CDL-версию файла MINC, отредактируйте файл CDL, чтобы изменить имя размеров, и
использование Минкген для создания соответствующего файла 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-файл с именем `х.mnc':

mincgen -o x.mnc foo.cdl

ИСПОЛЬЗОВАНИЕ

CDL Синтаксис Обзор
Ниже приведен пример синтаксиса CDL, описывающий файл MINC с несколькими именованными измерениями.
(xspace, yspace и zspace), переменные (zspace, изображение), атрибуты переменных (допустимый_ диапазон,
signtype) и некоторые данные. Ключевые слова CDL выделены жирным шрифтом. (Этот пример предназначен для
проиллюстрировать синтаксис; реальный файл CDL будет иметь более полный набор атрибутов, поэтому
что данные будут более самоописательными.)

NetCDF foo {// пример спецификации MINC в CDL

размеры:
хспейс = 8;
yпробел = 8;
zпробел = 5;

переменные:
плавать хспейс;
плавать yпробел;
плавать zspace (zspace);
короткие изображение (zspace, yspace, xspace);
двойной изображение-мин (zspace)
двойной изображение-макс (zspace)

// переменные атрибуты
изображение: valid_range = 0,5;
данным:
image-min = -1,-1,-1,-1,-1;
изображение-макс = 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 атрибут обозначается переменной и именем атрибута, разделенными `: '. Это
можно назначить Глобальный атрибуты, не связанные с какой-либо переменной файла как
целиком, используя ":" перед именем атрибута. Тип данных атрибута в CDL:
производный от типа присвоенного ему значения. Длина атрибута - это
количество присвоенных ему значений данных или количество символов в символьной строке
назначенный на это. Множественные значения присваиваются несимвольным атрибутам путем разделения
значения через запятую. Все значения, присвоенные атрибуту, должны быть одного типа.

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

Необязательный данным В разделе спецификации 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 нормализованные числа с плавающей запятой одинарной точности. реальные принято как
синоним для плавать в декларациях CDL.

Двойники могут содержать значения от -1.7 + 308 до 1.7 + 308. Их внешнее представление
представляет собой 64-битные нормализованные числа с плавающей запятой двойной точности, соответствующие стандарту IEEE.

CDL Константы
Константы, присвоенные атрибутам или переменным, могут быть любого из основных типов MINC. В
синтаксис для констант аналогичен синтаксису C, за исключением того, что суффиксы типа должны быть добавлены к
шорты и поплавки, чтобы отличать их от длинных и двойных.

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

Символьные константы заключаются в двойные кавычки. Может быть представлен массив символов
в виде строки, заключенной в двойные кавычки. Соблюдаются обычные соглашения об экранировании строк C.
Например
"а" // ASCII `а '
"Two \ nlines \ n" // 10-символьная строка с двумя встроенными символами новой строки
"звонок: \ 007" // строка, содержащая звонок ASCII
Обратите внимание, что символьный массив "a" подходит для одноэлементной переменной, поскольку нет
предполагается завершающий символ NULL. Однако нулевой байт в массиве символов равен
интерпретируется как конец значимых символов минкдамп программа, следуя
соглашение C. Следовательно, байт NULL не должен быть встроен в символьную строку.
если только в конце: используйте байт тип данных вместо байтовых массивов, содержащих ноль
байт. MINC и CDL не имеют строкового типа, а только массивы символов фиксированной длины, которые могут
быть многомерным.

короткие Целочисленные константы предназначены для представления 16-битовых величин со знаком. Форма
в А короткие Константа - это целочисленная константа с добавленными буквами "s" или "S". Если короткие
константа начинается с `0 ', она интерпретируется как восьмеричная, за исключением того, что если она начинается с` 0x',
он интерпретируется как шестнадцатеричная константа. Например:
-2 с // короткое -2
0123s // восьмеричный
0x7ffs // шестнадцатеричный

Длинное Целочисленные константы предназначены для представления 32-битовых величин со знаком. Форма
в А длинной Константа - обычная целочисленная константа, хотя допустимо добавлять
необязательный l или L. Если длинной константа начинается с `0 ', она интерпретируется как восьмеричная,
за исключением того, что если он начинается с «0x», он интерпретируется как шестнадцатеричная константа. Примеры
действительных длинной константы включают:
-2
1234567890L
0123 // восьмеричный
0x7ff // шестнадцатеричный

Константы типа с плавающей запятой плавать подходят для представления с плавающей запятой
данные с точностью около семи значащих цифр. Форма плавать постоянная
то же самое, что и константа с плавающей запятой C с добавлением `f 'или` F'. Например,
все следующие приемлемы плавать константы:
-2.0ф
3.14159265358979f // будет усечено с меньшей точностью
1.ф

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

Используйте mincgen онлайн с помощью сервисов onworks.net