mincdump - Online in de cloud

PROGRAMMA:

NAAM

mincdump - Converteer minc-bestanden naar ASCII-vorm (CDL)

KORTE INHOUD

mincdump [-c] [-h] [-v var1,...] [-B LANG] [-F LANG] [-l len] [-N naam] [-P
f_cijfers[,d_cijfers]] filet

PRODUCTBESCHRIJVING

minidump is gebaseerd op de netCDF-tool ncdump, aangepast om te werken met zowel MINC 1 (netCDF)
en MINC 2 (HDF5)-formaatbestanden. Het is voornamelijk bedoeld voor gebruik met scripts zoals
mincdiff en minleider. Omdat het niet is gemaakt in het Montreal Neurological Institute
het volgt niet de gebruikelijke conventies voor MINC-programma's.

minidump genereert een ASCII-weergave van een opgegeven minc-bestand bij standaarduitvoer.
De ASCII-representatie is in een vorm genaamd CDL (``network Common Data form Language'')
die kunnen worden bekeken, bewerkt of als invoer kunnen dienen voor ncgen. ncgen is een begeleidend programma dat
kan een binair minc-bestand genereren op basis van een CDL-bestand. Vandaar ncgen en minidump kan worden gebruikt als
inverses om de gegevensrepresentatie te transformeren tussen binaire en ASCII-representaties.
Bekijk ncgen voor een beschrijving van CDL- en netCDF-representaties.

minidump definieert een standaardindeling die wordt gebruikt voor elk type netCDF-gegevens, maar dit kan
gewijzigd als een `C_format'-attribuut is gedefinieerd voor een netCDF-variabele. In dit geval,
minidump zal het kenmerk `C_format' gebruiken om elke waarde op te maken. Bijvoorbeeld, als
drijvende-kommagetalgegevens voor de netCDF-variabele `Z' staan ​​bekend als nauwkeurig tot op drie
significante cijfers, zou het gepast zijn om het variabele attribuut te gebruiken

Z:C_format = "%.3g"

minidump kan ook worden gebruikt als een eenvoudige browser voor netCDF-gegevensbestanden, om de
afmetingen namen en maten; namen, typen en vormen van variabelen; attribuutnamen en waarden;
en optioneel de waarden van gegevens voor alle variabelen of geselecteerde variabelen in een netCDF
bestand.

minidump gebruikt `_' om gegevenswaarden weer te geven die gelijk zijn aan het kenmerk `_FillValue'
voor een variabele, bedoeld om gegevens weer te geven die nog niet zijn geschreven. Als een variabele
geen kenmerk `_FillValue' heeft, wordt de standaardvulwaarde voor het type variabele gebruikt als de
variabele is niet van het bytetype.

OPTIES

-c Toon de waarden van coördineren variabelen (variabelen die ook dimensies zijn) as
evenals de declaraties van alle dimensies, variabelen en attribuutwaarden. Gegevens
waarden van niet-coördinaatvariabelen worden niet opgenomen in de uitvoer. Dit is de
meest geschikte optie om te gebruiken voor een korte blik op de structuur en inhoud van a
netCDF-bestand.

-h Toon alleen de hoofd informatie in de output, dat zijn de verklaringen van
dimensies, variabelen en attributen, maar geen gegevenswaarden voor variabelen. De
uitvoer is identiek aan het gebruik van de -c optie behalve dat de waarden van coördinaat
variabelen zijn niet inbegrepen. (Maximaal één van) -c or -h opties kunnen aanwezig zijn.)

-v var1,...,varn
De uitvoer bevat gegevenswaarden voor de opgegeven variabelen, naast de
declaraties van alle dimensies, variabelen en attributen. Een of meer variabelen
moet bij naam worden opgegeven in de door komma's gescheiden lijst na deze optie. De
lijst moet een enkel argument zijn voor de opdracht, en mag daarom geen spaties of andere bevatten
witruimte tekens. De benoemde variabelen moeten geldige netCDF-variabelen zijn in de
Invoer bestand. De standaard, zonder deze optie en bij afwezigheid van de -c or -h
opties, is om gegevenswaarden op te nemen voor: allen variabelen in de uitvoer.

-b LANG
Een korte annotatie in de vorm van een CDL-commentaar (tekst die begint met de tekens
``//'') wordt opgenomen in de gegevenssectie van de uitvoer voor elke `rij' met gegevens,
om gegevenswaarden voor multidimensionale variabelen te helpen identificeren. Indien LANG begint met
`C' of `c', dan worden C-taalconventies gebruikt (indices op basis van nul, laatste
afmeting varieert het snelst). Indien LANG begint met `F' of `f', daarna Fortran-taal
conventies worden gebruikt (indices op één basis, eerste dimensie varieert het snelst). In
in beide gevallen worden de gegevens in dezelfde volgorde weergegeven; alleen de annotaties
zal verschillen. Deze optie is handig om door grote hoeveelheden
multidimensionale gegevens.

-f LANG
Volledige annotaties in de vorm van CDL-opmerkingen (tekst die begint met de .)
tekens ``//'') voor elke gegevenswaarde (behalve individuele tekens in teken
arrays) worden opgenomen in de gegevenssectie. Indien LANG begint met `C' of `c', dan
C-taalconventies zullen worden gebruikt (indices op basis van nul, laatste dimensie varieert)
snelste). Indien LANG begint met `F' of `f', dan zullen de Fortran-taalconventies
worden gebruikt (indices op basis van één, eerste dimensie varieert het snelst). In beide gevallen is de
gegevens worden in dezelfde volgorde weergegeven; alleen de annotaties zullen verschillen. Dit
optie kan handig zijn om gegevens naar andere filters te leiden, aangezien elke gegevenswaarde
verschijnt op een aparte regel, volledig geïdentificeerd.

-l len Wijzigt de standaard maximale regellengte (80) die wordt gebruikt bij het opmaken van lijsten van niet-
karakter data waarden.

-n naam
CDL vereist een naam voor een netCDF-dataset, voor gebruik door: ncgen -b bij het genereren van een
standaard netCDF-bestandsnaam. Standaard, minidump construeert deze naam uit de laatste
component van de padnaam van het invoernetCDF-bestand door elke extensie te verwijderen
het heeft. Gebruik de -n optie om een ​​andere naam op te geven. Hoewel het uitvoerbestand
naam gebruikt door ncgen -b kan worden gespecificeerd, kan het verstandig zijn om minidump verander de
standaardnaam om te voorkomen dat per ongeluk een waardevol netCDF-bestand wordt overschreven bij gebruik
minidump, bewerk het resulterende CDL-bestand en gebruik ncgen -b om een ​​nieuwe te genereren
netCDF-bestand van het bewerkte CDL-bestand.

-p float_digits[,dubbele_cijfers]
Specificeert de standaardprecisie (aantal significante cijfers) om te gebruiken bij het weergeven
gegevenswaarden met drijvende komma of dubbele precisie voor attributen en variabelen. Indien
gespecificeerd, overschrijft deze waarde de waarde van het `C_format' attribuut voor any
variabele die zo'n attribuut heeft. Drijvende-kommagegevens worden weergegeven met
float_digits significante cijfers. Indien dubbele cijfers wordt ook gespecificeerd, dubbel-
precisiewaarden worden weergegeven met zoveel significante cijfers. In de
afwezigheid van enige -p specificaties, drijvende-komma- en dubbele-precisiegegevens zijn:
weergegeven met respectievelijk 7 en 15 significante cijfers. CDL-bestanden kunnen worden gemaakt
kleiner als minder precisie vereist is. Als zowel drijvende-komma als dubbele druk
precisies zijn opgegeven, moeten de twee waarden worden gescheiden door een komma (no
blanks) als een enkel argument voor de opdracht. Als je echt elk laatste beetje wilt
precisie van het netCDF-bestand weergegeven in het CDL-bestand voor alle mogelijke
drijvende-kommawaarden, moet u dit specificeren met -p 9,17 (volgens
Stelling 15 van het artikel vermeld onder REFERENTIES).

Voorbeelden

Kijk naar de structuur van de gegevens in het netCDF-bestand `foo.mnc':

mincdump -c foo.mnc

Produceer een geannoteerde CDL-versie van de structuur en gegevens in het netCDF-bestand `foo.mnc',
met behulp van C-stijl indexering voor de annotaties:

mincdump -bc foo.mnc > foo.cdl

Voer alleen gegevens uit voor de variabelen `uwind' en `vwind' uit het netCDF-bestand `foo.mnc', en
toon de drijvende-kommagegevens met slechts drie significante precisiecijfers:

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

Maak een volledig geannoteerde lijst (één gegevenswaarde per regel) van de gegevens voor de variabele
`omega', Fortran-conventies gebruiken voor indices en de naam van de netCDF-dataset wijzigen in
het resulterende CDL-bestand naar `omega':

mincdump -v omega -f fortran -n omega foo.mnc > Z.cdl

Gebruik mincdump online met behulp van onworks.net-services