mgd77managegmt - Online in de cloud

PROGRAMMA:

NAAM

mgd77manage - Beheer de inhoud van MGD77+ bestanden

KORTE INHOUD

mgd77 beheren NGDC-id's [[+]a|c|d|D|e|E|g|i|n|t|Tfileinfo ] [ f|g|e ] [ afkorting1,afkorting2, ...)
] [ leeg ] [ ] [ afgekort/naam/eenheid/t/schaal/compenseren/commentaar ] [ eenheid ] [ regio ] [ [niveau]
] [ -bi] [ -du] [ -n]

Opmerking: Er is geen spatie toegestaan ​​tussen de optievlag en de bijbehorende argumenten.

PRODUCTBESCHRIJVING

mgd77 beheren behandelt het onderhouden van extra aangepaste kolommen in MGD77+ netCDF-bestanden. Jij kan
ofwel een of meer kolommen verwijderen, een nieuwe kolom toevoegen, een bestaande kolom bijwerken met nieuwe
gegevens, of geef foutcorrectie-informatie (*.e77-bestanden). Nieuwe gegevens kunnen uit een tabel komen
(ASCII tenzij -bi wordt gebruikt), gebaseerd zijn op bestaande kolommen en bepaalde theoretische
uitdrukkingen, of ze kunnen worden verkregen door een raster te samplen (kies tussen GMT-raster of a
Sandwell/Smith Mercator *.img raster) langs het spoor. De nieuwe gegevens worden toegevoegd aan de
MGD77+ bestand in de vorm van een extra gegevenskolom van een bepaald type. Het gegevensbestand wordt
gewijzigd; er wordt geen nieuw bestand aangemaakt. Zie de sectie DISCUSSIE voor de grote problemen
hieronder.

VERPLICHT ARGUMENTEN

NGDC-id's
Kan een of meer van de vijf soorten bestekschrijvers zijn:

1. NGDC-ID's van 8 tekens, bijv. 01010083, JA010010 enz.

2. 2-karakter codes die alle cruises van elk agentschap zullen retourneren.

3. 4-karakter codes, die alle cruises daarvan teruggeven
schepen.

4. = , waar is een tabel met NGDC-ID's, één per regel.

5. Als er niets is opgegeven, zetten we alle cruises terug in de database.

(Zie mgd77info -L voor agentschappen en scheepscodes). De extensies ".mgd77" of ".nc"
wordt automatisch toegevoegd, indien nodig (gebruik -I om bepaalde bestandstypen te negeren).
Cruisebestanden worden eerst in de huidige map en als tweede in totaal gezocht
mappen vermeld in $MGD77_HOME/mgd77_paths.txt [Als $MGD77_HOME is niet ingesteld
zal standaard op $GMT_SHAREDIR/mgd77].

OPTIONELE ARGUMENTEN

-A[+]a|c|d|D|e|E|g|i|n|t|Tfileinfo
Voeg een nieuwe gegevenskolom toe. Als er al een bestaande kolom met dezelfde afkorting is
bestaat in het bestand zullen we laf weigeren om het bestand bij te werken. Specificeren -A+
overwint deze terughoudendheid (soms kan een bestaande kolom echter niet worden geüpgraded)
zonder het eerst te verwijderen; dan wordt u gewaarschuwd). Selecteer een kolombroncode
onder a, c, d, D, e, g, i, n, tof T; gedetailleerde beschrijvingen voor elke keuze
volgen:

a Voeg bestandsnaam toe van een tabel met één kolom om toe te voegen. Bestand moet hetzelfde nummer hebben
van rijen als het MGD77+-bestand. Als er geen bestand wordt gegeven, lezen we in plaats daarvan uit stdin.

c Maak een nieuwe kolom die is afgeleid van bestaande gegevens of formules voor correcties
en referentievelden. toevoegen c voor de Carter-correcties afgetrokken van
ongecorrigeerde diepten, g voor het IGF-zwaartekrachtreferentieveld (ook bekend als "normale zwaartekracht"),
m voor het IGRF totale veld magnetische referentieveld, en r voor herberekend magnetisch
anomalie (voeg 1 of 2 toe om aan te geven welke kolom voor het totale veld moet worden gebruikt [1]). voor zwaartekracht
we kiezen het referentieveld op basis van de parameter Gravity Theoretical Formula
Code in de MGD77-header van de cruise. Als dit niet is ingesteld of ongeldig is, gebruiken we standaard
de IGF 1980. U kunt dit gedrag overschrijven door de gewenste code toe te voegen: 1 =
Heiskanen 1924, 2 = Internationaal 1930, 3 = IGF1967, of 4 = IGF1980.

d Voeg bestandsnaam van een tabel met twee kolommen toe aan de eerste kolom met afstanden
langs het spoor en de tweede kolom met gegevenswaarden. Als er geen bestand wordt gegeven, lezen we
van stdin in plaats daarvan. Records met overeenkomende afstanden in het MGD77+-bestand worden
de nieuwe waarden toegewezen; op andere afstanden stellen we ze in op NaN. Als alternatief, geef
hoofdletters D in plaats daarvan zullen we de kolom op alle recordafstanden interpoleren.
Bekijk -N voor het kiezen van afstandseenheden en -C om te kiezen hoe afstanden zijn
berekend.

e Verwacht een e77-fout-/correctielogboek te vinden van mgd77 sniffer met de naam
NGDC_ID.e77 in de huidige directory of in $MGD77_HOME/E77; dit bestand zal worden onderzocht
en gebruikt om wijzigingen aan te brengen in de kopwaarden, specificeer een systematische
correctie voor bepaalde kolommen (zoals schaal en offset), specificeer dat een bepaalde
anomalie moet opnieuw worden berekend op basis van de waarnemingen (bijv. herbereken mag van
mtf1 en de nieuwste IGRF), en de speciale kolom toevoegen of bijwerken vlag die kan houden
bitflags (0 = GOED, 1 = SLECHT) voor elk gegevensveld in de standaard MGD77-gegevensset.
Eventuele vaste correctietermen gevonden (zoals een veld moeten schalen met 0.1 of 10
omdat het bronbureau onjuiste eenheden heeft gebruikt) worden geschreven als attributen naar
het netCDF MGD77+-bestand en toegepast wanneer de gegevens worden gelezen door mgd77lijst. Vluchtig
correcties zoals die bepaald door crossover-analyse worden niet bewaard in de gegevens
bestanden, maar bevinden zich in correctietabellen (zie mgd77lijst voor details). Standaard is de
het eerste teken van elke kopregel in het e77-bestand (dat is ?, Y of N) is
geraadpleegd om te zien of de overeenkomstige aanpassing moet worden toegepast. indien van toepassing
onbesliste instellingen worden gevonden (ii, ?) zullen we afbreken en geen wijzigingen aanbrengen. Enkel en alleen
records gemarkeerd met Y worden verwerkt. U kunt dit gedrag overschrijven door er een toe te voegen
of meer modifiers voor de -Ae opdracht: h negeert alle koptekstcorrecties, f wil
negeer alle vaste systematische trendcorrecties, n, v en s zal bitflags negeren
met betrekking tot respectievelijk navigatie, gegevenswaarden en gegevenshellingen. Gebruik maken van -A+e naar
vervang eventuele bestaande E77-correcties in het bestand door de nieuwe waarden. Eindelijk, e77
correcties worden niet toegepast als het E77-bestand niet is geverifieerd. Gebruik maken van -AE naar
negeer de verificatiestatus.

g Proef een GMT geografisch (lon, lat) raster langs het spoor dat wordt gegeven door het MGD77+-bestand
met behulp van bicubische interpolatie (zie echter -n). Voeg de naam van een GMT-rasterbestand toe.

i Proef een Sandwell/Smith Mercator *.img-raster langs het spoor van de MGD77+
bestand met behulp van bicubische interpolatie (zie echter -n). Voeg de img-rasterbestandsnaam toe,
gevolgd door de door komma's gescheiden gegevensschaal (meestal 1 of 0.1), de IMG-bestandsmodus
(0-3) en optioneel het img grid max latitude [80.738). De modi staan ​​voor de
volgende: (0) Img-bestanden zonder beperkingscode, retourneert gegevens op alle punten, (1)
Img-bestand met gecodeerde beperkingen, retourneert gegevens op alle punten, (2) Img-bestand met
beperkingen gecodeerd, gegevens alleen retourneren op beperkte punten en NaN elders, en
(3) Img-bestand met gecodeerde beperkingen, retourneer 1 bij beperkingen en 0 elders.

n Voeg bestandsnaam toe van een tabel met twee kolommen, waarbij de eerste kolom het record bevat
nummer (0 tot nrows - 1) en de tweede kolom met gegevenswaarden. Als er geen bestand is
gezien we in plaats daarvan lezen van stdin. Records met overeenkomende recordnummers in de
MGD77+-bestand krijgt de nieuwe waarden toegewezen; bij andere records zetten we ze op NaN.

t Voeg bestandsnaam toe van een tabel met twee kolommen, waarbij de eerste kolom absoluut is
tijden langs het spoor en de tweede kolom met gegevenswaarden. Als er geen bestand wordt gegeven,
lees in plaats daarvan uit stdin. Records met overeenkomende tijden in het MGD77+ bestand worden
de nieuwe waarden toegewezen; op andere momenten stellen we ze in op NaN. Als alternatief, geef
hoofdletters T in plaats daarvan zullen we de kolom op alle recordtijden interpoleren.

-Cf|g|e
Voeg een code van één letter toe om de procedure voor de afstand over het spoor te selecteren
berekening bij gebruik -Advertentie|D (Zie -N voor het selecteren van afstandseenheden):

f Platte aarde afstanden.

g Grootcirkelafstanden [Standaard].

e Geodetische afstanden op de huidige GMT-ellipsoïde.

-Dafkorting1,afkorting2, ...)
Geef een door komma's gescheiden lijst met kolomafkortingen waaruit u wilt verwijderen
de MGD77+ bestanden. Gebruik deze optie NIET om kolommen te verwijderen die u vervangt
met nieuwe gegevens (gebruik -A+ in plaats daarvan). Omdat we geen variabelen uit netCDF kunnen verwijderen
bestanden moeten we een nieuw bestand maken zonder de kolommen die moeten worden verwijderd. Zodra het bestand is
succesvol aangemaakt we hernoemen tijdelijk het oude bestand, verander de nieuwe bestandsnaam in
de oude bestandsnaam en verwijder tenslotte het oude, hernoemde bestand.

-Eleeg
Geef een enkel teken dat zal worden herhaald om lege tekenreekswaarden te vullen, bijv.
"9" levert een string op zoals "99999..." [9].

-F Forceer modus. Wanneer deze modus actief is, bent u bevoegd om even . te verwijderen of te vervangen
de standaard MGD77 kolommenset. Je kunt maar beter weten wat je doet!

-Iafgekort/naam/eenheid/ t /schaal/compenseren/commentaar
Naast bestandsinformatie moeten we aanvullende informatie specificeren over de
extra kolom. Specificeer een korte (16 char of minder, met kleine letters, cijfers,
of alleen onderstrepingstekens) afkorting voor de geselecteerde gegevens, de meer beschrijvende naam,
de data-eenheid, het datatype 1-cijferige code (btoch, skort, fveel, inee, double, of
text) die u wilt gebruiken voor opslag in het netCDF-bestand, elke schaal en offset moeten we
toepassen op de gegevens om ze te laten passen binnen het bereik dat wordt geïmpliceerd door de gekozen opslag
type, en een algemene opmerking (< 128 tekens) over wat deze gegevens vertegenwoordigen.
Opmerking: Als het tekstgegevenstype is geselecteerd, dan zijn de termen "waarden" in de -A discussie
verwijzen naar uw tekstgegevens. Bovendien gaat de discussie over interpolatie niet
toepassen en de NaN-waarde wordt een "geen string" -waarde (zie -E voor wat dit is).
Plaats aanhalingstekens rond termen met meer dan één woord (bijv. "Gecorrigeerde diepte").

-Neenheid Voeg de afstandseenheid toe (zie EENHEDEN). [Standaard is -Nk (km)]. Alleen relevant wanneer
-Ag|i is geselecteerd.

-R[eenheid]x min/xmax/ymin/ymax[R] (meer ...)
Geef de regio van interesse op. Alleen relevant wanneer -Ag|i is geselecteerd.

-V[niveau] (meer ...)
Selecteer breedsprakigheidsniveau [c].

-bi[ncols][T] (meer ...)
Selecteer native binaire invoer. Dit geldt voor de invoergegevensbestanden met 1 of 2 kolommen
gespecificeerd onder sommige van de -A opties. De binaire invoeroptie is alleen beschikbaar
voor numerieke gegevenskolommen.

-dugeen informatie (meer ...)
Vervang invoerkolommen die gelijk zijn aan geen informatie met NaN.

-n[b|c|l|n][+a][+bBC][+c][+tdrempel] (meer ...)
Selecteer interpolatiemodus voor rasters.

-^ or voor slechts -
Druk een kort bericht af over de syntaxis van de opdracht en sluit vervolgens af (OPMERKING: op Windows
gebruik gewoon -).

-+ or voor slechts +
Druk een uitgebreid gebruiks(help)bericht af, inclusief de uitleg van eventuele
module-specifieke optie (maar niet de algemene GMT-opties), en wordt vervolgens afgesloten.

-? or geen argumenten
Druk een volledig gebruiks(help)bericht af, inclusief de uitleg van de opties, dan
uitgangen.

--versie
GMT-versie afdrukken en afsluiten.

--show-datadir
Druk het volledige pad af naar de GMT-sharedirectory en sluit af.

UNITS

Voor kaartafstandseenheid, voeg toe eenheid d voor booggraad, m voor boogminuut, en s voor boog
tweede, of e voor meter [Standaard], f voor voet, k voor kilometer, M voor statuut mijl, n voor nautische
mijl, en u voor Amerikaanse onderzoeksvoet. Standaard berekenen we dergelijke afstanden met behulp van een sferische
benadering met grote cirkels. voeg toe - tot een afstand (of de eenheid is geen afstand is
gegeven) om "Flat Earth"-berekeningen uit te voeren (sneller maar minder nauwkeurig) of prepend + naar
exacte geodetische berekeningen uitvoeren (langzamer maar nauwkeuriger).

GEVOLGEN OF GRID OPNIEUW BEMONSTEREN

Voor het opnieuw bemonsteren of bemonsteren van rasters worden verschillende algoritmen gebruikt (zie -n) die kan leiden tot:
mogelijke vervormingen of onverwachte resultaten in de opnieuw bemonsterde waarden. Een verwacht effect
van resamplen met splines is de neiging dat de nieuwe herbemonsterde waarden iets groter zijn dan
de globale min/max-limieten van het oorspronkelijke raster. Als dit onaanvaardbaar is, kunt u opleggen
knippen van de opnieuw bemonsterde waarden zodat ze de ingevoerde min/max-waarden niet overschrijden met
toe te voegen +c aan jouw -n optie.

Voorbeelden

Om Geosat/ERS-1 zwaartekracht versie 11.2 toe te voegen als extra datakolom in de cruises
01010047.nc en 01010008.nc, sla de waarden op als mGal*10 in een 2-byte kort geheel getal, probeer

gmt mgd77manage 01010047 01010008 -Ai10/1/grav.11.2.img \
-Isatgrav/"Geosat/ERS-1 zwaartekracht"/"mGal"/s/10/0/"Sandwell/Smith versie 11.2" -V

Om een ​​gefilterde versie van magnetics toe te voegen als een extra gegevenskolom van het type float voor de
cruise 01010047.nc, en interpoleer de gefilterde gegevens op de tijden die in de MGD77+
bestand, probeer

gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag/"Tussengolflengte \
magnetische residuen"/"nTesla"/f/1/0/"Nuttig voor het zoeken naar isochrons" -V

Om de bestaande extra kolommen satfaa, coastdist en satvgg uit alle MGD77+ bestanden te verwijderen,
proberen

gmt mgd77manage =allmgd77.lis -Dsatfaa,kustdist,satvgg -V

Om een ​​zwevende kolom van 4 bytes met het juiste IGRF-referentieveld in alle MGD77+-bestanden te maken,
proberen

gmt mgd77manage =allmgd77.lis -Acm -Iigrf/"IGRF-referentie \
field"/"nTesla"/f/1/0/"IGRF versie 10 voor 1990-2010" -V

DISCUSSIE

1. Preambule

Het mgd77-supplement is een poging om (1) de beperkte functionaliteit van de
bestaand mgg-supplement, (2) neem enkele van de ideeën van het gmt+-supplement van Scripps op
door extra gegevenskolommen toe te staan, en (3) nieuwe mogelijkheden toe te voegen voor het beheer van maritieme
geofysische trackline-gegevens opgeslagen in een architectuuronafhankelijke CF-1.0- en
COARDS-compatibel netCDF-bestandsformaat. Hier zijn enkele van de onderliggende ideeën en stappen die u
moet nemen om uw bestanden te onderhouden.

2. Introductie

Ons uitgangspunt zijn de MGD77 ASCII-gegevensbestanden die vanuit NGDC op cd-roms worden gedistribueerd,
dvd-roms en via FTP. Gebruikmakend van Geodas om de bestanden lokaal te installeren, kiezen we de "Carter
gecorrigeerde diepte" optie die de dieptekolom vult met behulp van de reistijden in twee richtingen
en de Carter-tabellen als twt aanwezig is. Deze stap levert ~ 5000 individuele cruisebestanden op.
Plaats deze in een of meer submappen naar keuze, vermeld deze submappen (een
per regel) in het bestand mgd77_paths.txt, en plaats dat bestand in de map waarnaar wordt verwezen door
$MGD77_HOME; zo niet zet deze variabele standaard op $GMT_SHAREDIR/mgd77.

3. Camper ombouw

Converteer de ASCII MGD77-bestanden naar het nieuwe netCDF MGD77+ formaat met: mgd77 converteren.
Meestal maakt u een lijst van alle cruises die moeten worden omgebouwd (met of zonder
extensie), en u voert vervolgens
mgd77convert =cruises.lis -Fa -Tc -V -Lwe+ > log.txt

De uitgebreide instellingen zorgen ervoor dat alle problemen die tijdens de conversie worden gevonden, worden
gemeld. De nieuwe *.nc-bestanden kunnen ook in een of meer afzonderlijke submappen worden geplaatst
en deze moeten ook worden vermeld in het bestand mgd77_paths.txt. We raden u aan om de
mappen met *.nc-bestanden vóór de *.mgd77-mappen. Wanneer u later wilt beperken
een zoekopdracht naar bestanden met een bepaalde extensie moet u de . gebruiken -I optie.

4. Het toevoegen van nieuwe kolommen

mgd77 beheren kunt u extra gegevenskolommen toevoegen aan uw *.nc-bestanden. Deze kunnen zijn
alles, inclusief tekenreeksen, maar hoogstwaarschijnlijk zijn het numerieke waarden die zijn gesampled langs de
track van een geleverd raster of een bestaande kolom die zijn gefilterd of gemanipuleerd
voor een bepaald doel. Het formaat ondersteunt maximaal 32 van dergelijke extra kolommen. Zie deze man
pagina voor het toevoegen van kolommen. U kunt later besluiten om enkele van deze kolommen te verwijderen of
update de gegevens die bij een bepaalde kolom horen. Tools voor gegevensextractie, zoals: mgd77lijst
kan worden gebruikt om een ​​mix van standaard MGD77-kolommen te extraheren (navigatie, tijd en de gebruikelijke)
geofysische waarnemingen) en uw aangepaste kolommen.

5. Fout bronnen

Voordat we bespreken hoe fouten kunnen worden gecorrigeerd, zullen we eerst de verschillende klassen van fouten opsommen
geassocieerd met MGD77-gegevens: (1) Headerrecord-fouten treden op wanneer een deel van de informatie
velden in de koptekst voldoen niet aan de MGD77-specificatie of vereiste informatie is
missend. mgd77 converteren zal deze fouten weergeven wanneer de uitgebreide uitgebreide instelling is
geselecteerd. Deze fouten hebben meestal geen invloed op de gegevens en zijn in plaats daarvan fouten in de
metadata (2). Vaste systematische fouten treden op wanneer een bepaalde gegevenskolom, ondanks de
MGD77-specificatie, is onjuist gecodeerd. Dit betekent meestal dat de gegevens uitgeschakeld zijn
door een constante factor zoals 10 of 0.1, of in sommige gevallen zelfs 1.8288 die converteert
vadem naar meter. (3) Onbekende systematische fouten treden op wanneer het instrument dat registreerde
de gegevens of de verwerking die volgden introduceerde signalen die systematisch lijken te zijn
functies van tijd langs spoor, breedtegraad, koers of een andere combinatie van termen die
een fysieke of logische verklaring hebben. Deze voorwaarden kunnen soms worden opgelost door gegevens
analysetechnieken zoals langs-track en cross-track onderzoeken, en zullen resulteren in
in correctietermen dat wanneer toegepast op de gegevens deze ongewenste signalen in een
optimale manier. Omdat deze correctietermen kunnen veranderen wanneer nieuwe gegevens worden overwogen in
hun vastberadenheid, worden dergelijke correcties als kortstondig beschouwd. (4) Individuele gegevens
punten of gegevensreeksen kunnen regels overtreden, zoals buiten mogelijke bereiken zijn of
op andere manieren het gezond verstand schenden. Verder kunnen reeksen punten die binnen geldig
bereiken kunnen aanleiding geven tot gegevensgradiënten die onredelijk zijn. De status van elk punt
kan daarom worden bepaald en dit geeft aanleiding tot bitflags GOOD of BAD. Ons beleid is:
dat foutbronnen 1, 2 en 4 worden gecorrigeerd door de informatie als metadata aan te leveren
in de relevante *.nc-bestanden, terwijl de correcties voor foutbron 3 (omdat ze
voortdurend worden verbeterd) wordt bijgehouden in een aparte lijst met correcties.

6. Het vinden van fouten

De mgd77 sniffer is een tool die een grondige geestelijke gezondheidscontrole van het origineel uitvoert
MGD77 ASCII-bestanden en produceert een bijbehorend *.e77-foutlogboek. Alle gevonden problemen zijn:
gecodeerd in het foutenlogboek, en indien nodig worden aanbevolen vaste correctietermen gegeven. Een
analist kan verifiëren dat de voorgestelde correcties inderdaad geldig zijn (we willen alleen
corrigeer echt voor de hand liggende eenheidsfouten), bewerk deze foutenlogboeken en wijzig dergelijke correctietermen
en activeer ze door de relevante codesleutel te wijzigen (zie mgd77 sniffer voor meer details).
mgd77 beheren kan deze foutenlogboeken opnemen en (1) slechte headerrecords corrigeren gezien de
suggesties in het logboek, (2) voeg schaal/offset-correctietermen in die bij het lezen moeten worden gebruikt
bepaalde kolommen, en (3) eventuele gevonden bit-vlaggen invoegen. Voer deze stap opnieuw uit als u later vindt
andere problemen, aangezien alle E77-instellingen of -vlaggen opnieuw worden gemaakt op basis van het laatste E77-logboek.

7. Fout correcties

Het extractieprogramma mgd77lijst maakt het mogelijk om direct correcties toe te passen wanneer gegevens
worden gevraagd. Ten eerste worden gegevens met BAD-bitflags onderdrukt. Ten tweede, gegevens met vast
systematische correctietermen worden dienovereenkomstig gecorrigeerd. Ten derde, gegevens met kortstondige
Bij correctietermen worden die correcties toegepast (mits er een correctietabel wordt aangeleverd).
Al deze stappen vereisen de aanwezigheid van de relevante metadata en ze kunnen allemaal worden overruled
door de gebruiker. Bovendien kunnen gebruikers hun eigen bitflags toevoegen als afzonderlijke gegevenskolommen en
. mgd77lijst's logische tests om verder te dicteren welke gegevens van de uitvoer worden onderdrukt.

CREDITS

De IGRF-berekeningen zijn gebaseerd op een Fortran-programma geschreven door Susan Macmillan, Brits
Geological Survey, vertaald naar C via f2c door Joaquim Luis, en aangepast aan GMT-stijl door
Paul Wessel.

Gebruik mgd77managegmt online met onworks.net-services