Useful Info - wmo-im/et-acdm GitHub Wiki

Collection of Info for the OSCAR MetaData Understanding and Handling

  1. Steps Taken During Environment Setup and Use of WMO MD Handling Examples
  2. WDCs and CDCs Contact List
  3. Useful Links
  4. OSCAR Video Tutorials

Personal (DV) Notes: Steps Taken During Environment Setup and Use of WMO (Timo’s) MD Handling Examples

WMO (Timo's) examples are in GitHub can be found: https://github.com/kurt-hectic/wmo-api-webinar.git

Setup

  1. Download and Install Anaconda
  2. Download and Install GIT (With Timo’s guidance I have done it; I do not know where exactly it is), however:
  • Searching on my laptop for GIT, I find GIT CMD App, GIT GUI and GIT Bash
  • Choosing GIT CMD App there are several options: Open (opens CMD terminal C:\Users\drale> and if you type git you get usage: git […..])
  • Choosing “Open File Location” I see the path: Microsoft > Windows > Start Menu> Programs > Git: Git Bash, Git CMD and Git GUI
  • Would like to try Git GUI
  • I do not have Github.
  1. Cloning Timo’s setup:
  • Go https://github.com/kurt-hectic/wmo-api-webinar/ and choose Clone or Download and then either Open in Desktop or Download ZIP options (I may have done both). And it was stored in my Documents. Anyhow, in doing so I created 1 or more wmo-api-webinar copies in my Documents, which later I got rid of (do not know when exactly in this process) Back to CMD Terminal, cd to Documents/wmo-api-webinar/master and execute pip install -r requirements.txt (to get libs and it worked). While in the Documents/wmo-api-webinar/master dir, tried executing git remote and it failed. It may be at this stage I got rid of the multiple dirs..
  • Cd to Documents,
  • I now went for HTTPS cloning (?) (link: https://github.com/kurt-hectic/wmo-api-webinar.git). That is the 3rd option. On the CMD line execute: git clone https://github.com/kurt-hectic/wmo-api-webinar.git and sub directory Documents/wmo-api-webinar was created. All Timo’s staff is there.
  1. Tips:
  • To update my version from Timo’s use: git pull
  • To get (newer) development version as it was needed to run Example #4 pip install git+git://github.com/kurt-hectic/oscar-client.git@develop

Running (Emulating) Timo's Examples

  1. Launched ANACONDA Navigator and via Environments>base(root) started Jupyter Notebook. Navigated to Documents/wmo-api-webinar where I could see Timo’s files and examples.

  2. Running Timo’s Examples (I created Token earlier via OSCAR):

  • Example #0 (Simple API upload): executed cell by cell and it worked (see output below):

uploaded ok, but with warnings. new id 47483 log The list below is organized by section header and shows exceptions/issues � if any � that may have resulted from the processing of the XML (NB: Section headers are always displayed). # Facility with identifier "0-20000-0-teststationblog" REF_5: ReferenceType for "facility/programAffiliation/programAffiliation xlink:href" with URL "http://codes.wmo.int/wmdr/GOS2" could not be found. Information for "facility/programAffiliation" is discarded.

  • Example #1 (Changed Stations): executed cell by cell and it worked (see output below):

ADAMCLISI was modified on 2020-01-19 00:02:00 ADJUD was modified on 2020-01-19 00:02:00 ALBA IULIA was modified on 2019-01-24 00:12:00 ALEXANDRIA was modified on 2019-01-26 00:09:00 APA NEAGRA was modified on 2020-01-19 00:02:00 ARAD was modified on 2019-01-26 00:09:00 BACAU was modified on 2020-01-19 00:02:00 BACLES was modified on 2020-01-19 00:02:00 BAIA MARE was modified on 2019-01-19 00:12:00 BAILE HERCULANE was modified on 2019-01-26 00:09:00 BAILESTI was modified on 2020-01-19 00:02:00 BAISOARA was modified on 2019-01-19 00:12:00 BALEA LAC was modified on 2019-01-08 00:08:00 BANLOC was modified on 2019-01-19 00:12:00 BARAOLT was modified on 2019-01-19 00:12:00 BARLAD was modified on 2020-01-19 00:02:00 BARNOVA was modified on 2019-01-19 00:12:00

  • Example #2 (Re-Create Volume A): Not tried yet.

  • Example #3 (Update Stations): While executing cell by cell: it could not find jellyfish lib. Timo suggested piping it (pip install jellyfish) which I did. It continued running but failed at the very end when saving. It looks I do not have authorisation (see below): updating station 0-20000-0-10505 validates ok INFO:oscar_lib.oscar_client:Access not granted (401) error INFO:root:uploaded original XML to set gml:id. Status: AUTH_ERROR

Exception Traceback (most recent call last) in 21 22 ---> 23 station.save(client) 24 print("saved",wigos_id) 25

~\anaconda3\lib\site-packages\oscar_lib\station.py in save(self, client, override_doublesave) 232 233 if not status in ['SUCCESS_WITH_WARNINGS','SUCCESS']: --> 234 raise Exception("error saving original XML ({})".format(status)) 235 236 new_xml = str(self)

Exception: error saving original XML (AUTH_ERROR)

  • Example #4 (Create Stations): executed cell by cell and it failed very early in the setup (see below):

ImportError Traceback (most recent call last) in 10 import re 11 ---> 12 from oscar_lib import OscarClient, Station, OscarGUIClient 13 14 import pkg_resources # part of setuptools ImportError: cannot import name 'OscarGUIClient' from oscar_lib' (C:\Users\drale\anaconda3\lib\site-packages\oscar_lib_init_.py)


WDCs and CDCs Contact List

  1. WDCGG: World Data Center for Greenhouse Gases in Tokyo/Japan; Contact: Atsuya Kinoshita; [email protected]

  2. WRDC: World Radiation Data Center in St Petersburg/Russia; Contact: Anatoly Tsvetkov (Head of WRDC) [email protected] , [email protected] , [email protected]

  3. WDCRG: World Data Center for Reactive Gasses & WDCA World Data Center for Aerosol in Oslo/Norway; Contacts: Markus Fiebig (Senior Scientist) , [email protected] and Kjetil Tørseth (Department Director), [email protected]

  4. WOUDC: World Data Center for Ozone and UV Radiation inToronto/Canada; Contact: Tom Kralidis (Head of WOUDC), [email protected]

  5. WDCPC: World Data Center for Precipitation Chemistry in USA Collocated with NADP (National Atmospheric Deposition Program); Contact: Christopher Lehmann (Head of WDCPC) [email protected]

  6. SHADOZ: Southern Hemisphere Additional Ozonesondes; SHADOZ contacts: Debra E. Kollonige (Data Manager), [email protected] and Ryan M. Stauffer (PI/Head and QC/QA): [email protected] [email protected]

  7. NDACC (Network for the Detection of Atmospheric Composition Change): Contacts : Anne M. Thompson (former SHADOZ Head and co-Chair of NDACC expected to retire as co-chair at the end of 2021) [email protected], Martine De Mazière (co-Chair of NDACC), [email protected], NDACC data manager: Jeannette Wild [email protected]

  8. NASA data centre aircraft studies and NDACC new data center, Contact: Gao Chen [email protected]

  9. GALION: GAW Aerosol Lidar Observation Network and MPLNET: the NASA Micro Pulse Lidar Network (EARLINET is the European component of GALION), Contact: Ellsworth Judd Welton (Chair) [email protected]

  10. LALINET: Latin American Lidar Network in Brazil; Contact: Eduardo Landulfo, [email protected] ; [email protected]

  11. INDAAF- Africa: International Network to study Deposition and Atmospheric Africa; Contact: Corinne Gally-Lacaux, [email protected] , [email protected]

  12. CASTNET: Clean Air Status and Trends Network – EPA (Environment Protection Agency, HQ Washington DC); Contact: Melissa Puchanski [email protected]

  13. TCCON: TOTAL CARBON COLUMN OBSERVING NETWORK; Contact: Dietrich Feist (TCCON Deputy Chair for Africa & Europe): [email protected]

  14. CAPMON: Canadian Air and Precipitation Monitoring Network by Environment and Climate Change Canada (ECCC); Contacts: Bill Sukloff: [email protected] and Amanda Cole [email protected]

  15. EANET: Acid Deposition Monitoring Network in East Asia; Contact: Keiichi Sato, [email protected] , [email protected]

  16. SKYNET: Skyradiometer Network is International ground-based radiation observation network dedicated to aerosol-cloud-solar radiation interaction researches organized in seven regional sub-networks with their Regional SKYNET Data Centers (RSDC) and International SKYNET Data Center (ISDC); Contact: Terry Nakajima (Chair) [email protected]; Web site [email protected]

  17. ICOS: Integrated Carbon Observation System in Lund, Sweden; Contact: Alex Vermuelen (Manager), [email protected]

  18. IMPROVE: Interagency Monitoring of Protected Visual Environments based on AOD-Aerosol Optical Depth in USA Colorado State University; Contact: Bret Schichtel [email protected]


Useful Links

WIGOS Learning Portal: https://etrp.wmo.int/course/view.php?id=146&section=1; with 4 sections:

  1. WIGOS General
  2. OSCAR/Surface
  3. WDQMS and RWC
  4. Regular Webinars on OSCAR/Surface and WDQMS (in particular Webinar#1, Webinar#12 and Webinar#13)
  5. Other Relevant Learning Material

WMO Integrated Observing System (WIGOS):

https://community.wmo.int/activity-areas/wigos

And expand an appropriate section, in particular "WIGOS Tools" and "Capacity Development"

JSON/XML Templates:

https://mplnet.gsfc.nasa.gov/out/metadata/oscar/

WOUDC (Tom Kralidis) tools:

https://github.com/wmo-cop/pyoscar and https://github.com/geopython/pygeometa

Oscar Surface Manual:

https://library.wmo.int/?lvl=notice_display&id=20824#.X6rO2Wj7Q2w

https://library.wmo.int/index.php?lvl=notice_display&id=20824#.X5ceHyTfXDv

WIGOS Metadata Standard:

https://library.wmo.int/doc_num.php?xplnum_id=10109#:~:text=The%20WIGOS%20metadata%20should%20describe,are%20appropriate%20for%20their%20application.

WMDR Model and Schema Guide:

https://www.wmo.int/schemas/wmdr/1.0RC6/documentation/WMDR_ModelAndSchemaGuide.pdf

OSCAR Schemas:

https://schemas.wmo.int/wmdr/1.0RC9/

OSCAR test database:

https://oscardepl.wmo.int/surface

WMO Codes Registry:

http://codes.wmo.int/wmdr

WMDS Codetables English

https://github.com/wmo-im/wmds/tree/master/tables_en

Useful XML editors:

Oxygen XMLSpy

MPLNET WMDR XML Files, JSON template and XML file example

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/Welton%20WMDR%20Presentation%20August%202020.pdf

Useful Presentations and Other Documnets

Introduction_WIGOS_metadata_standard

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/2_Introduction_WIGOS_metadata_standard.pdf

Functional description of OSCAR/Surface

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/3%20Functional_description_OSCAR_Surface_English.pdf

Registering in OSCAR

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/5_Registering%20in%20OSCAR.pdf

How to Find Information in OSCAR/Surface

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/7_OSCAR-finding-info.pdf

How to Manage Information in OSCAR/Surface

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/8_How_to_manage_information_in_OSCAR_Surface.pdf

How to Create New Station

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/9_How_to_Create_new_station.pdf

WIGOS Metadata Representation & XML Schema

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/10_WMDS_representation_XML_schema.pdf

Machine to Machine Interface

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/11_Machine-to-machine_interface.pdf

OSCAR Surface User Manual

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/2019_oscar_surface_User_Manual.pdf

GAW Report 221

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/GAW_Report_221_en.pdf

Introduction to WIGOS

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/Introduction_to_WIGOS.pdf

Quick Guide How to Register in OSCAR or GAWSIS

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/Quick%20Guide%20How%20to%20register%20in%20OSCAR%20or%20GAWSIS.pdf

WMDR Model and Schema Guide

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/WMDR_ModelAndSchemaGuide.pdf

WMO Report 1192 WIGOS Metadata

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/WMO_%20Report_1192_en%20WIGOS%20metadata.pdf

GAW Metadata Key Elements Reporting - Survey

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/GAW%20Metadata%20Key%20Elements%20Reporting%20-%20Survey.pdf

Python Tools and Workflow for WIGOS Metadata Generation and OSCAR Publishing

https://github.com/wmo-cop/et-wdc/blob/master/docs/wiki/ET-WDC_Metadata_WOUDC_Kralidis_20200611.pdf


OSCAR Video Tutorials

⚠️ **GitHub.com Fallback** ⚠️