qgis-ndop-downloader

QGIS plugin and Python library for download species occurences from The Species Occurrence Database NCA CR

View the Project on GitHub OpenGeoLabs/qgis-ndop-downloader

NDOP Downloader

NDOP Downloader je aplikace, která slouží ke stahování nálezů z Nálezové databáze ochrany přírody AOPK ČR. Aplikace je dostupná ve dvou formách, jako QGIS zásuvný modul, jehož základ tvoří Python balíček ndop-downloader s nástrojem příkazové řádky ndop.

NDOP Downloader pouze zprostředkovává přístup k datům. Veškeré informace o datech - fungování databáze, licenční podmínky, citační pravidla týkající se dat naleznete na stránkách Nálezové databáze.

Pro použití databáze je nutné vytvořit účet v informačním systému AOPK (ISOP).

Hlavní výhody oproti webovému filtru:

Nevýhoda:

QGIS Plugin - NDOP Downloader

Zásuvný modul slouží ke stahování dat z nálezové databáze AOPK. V současné verzi je možné filtrovat na základě taxonu (druh,popř. rod) a definovaných regionů (katastrální území, CHKO, PP, atd.).

Výstupem jsou dostupná data lokalizací (.shp komprimované v .zip) a tabulková data (.csv) pro všechny záznamy. Lokalizace se po ukončení stahování nahrají do projektu. Tabulková data se nahrají do projektu jako Oddělený text a zobrazí se jako body (na základě souřadnic v tabulce). Tato data obsahují body a centroidy většiny polygonů a linií.

Instalace a Spouštění

Zásuvný modul předpokládá verzi LTR QGIS 3.4. Instaluje se jako ostatní moduly pomocí menu Zásuvné moduly --> Spravovat a instalovat zásuvné moduly. Je ale nutné povolit experimentální zásuvné moduly. V záložce nastavení zaškrtneme políčko Zobrazit také experimentální zásuvné moduly.

http://opengeolabs.cz/qgis_plugins.xml

Nyní už uvidíme zásuvný modul mezi ostatními v záložce Nenainstalované (nebo Vše.Vyhledáme NDOP Downloader, a nainstalujeme pomocí tlačítka Instalvoat zásuvný modul.

Po instalaci se přidá do menu Web položka NDOP Downloader a pro rychlé spuštění se objeví ikonka v liště.

Instalace vývojové verze

Zájemci si mohou stáhnout i vývojovou verzi, a nainstalovat pomocí záložky Instalovat ze ZIPu v okně Zásuvné moduly. Tato verze obsahuje nejčerstvější opravy a funkce, ale může obsahovat chyby, vnesené v průběhu dalšího vývoje.

Popis rozhraní

Přihlášení

Zadejte přihlašovací údaje pro informačním systém AOPK (ISOP). Pokud zaškrtnete položku Uložit přihlašovací údaje, údaje se uloží do konfiguračního souboru .ndop.cfg v domovském adresáři, a při dalším použití budou předvyplněny. V opačném případě budou údaje uložené pouze v rámci běžící instance QGIS, při dalším spuštění QGIS je bude potřeba zadat znovu.

Taxon

Druh lze vybrat pomocí rolovací nabídky, nebo vepsáním názvu s funkcí našeptávače. Lze zadávat česká i latinská jména.

Region

Obdobně jako u taxonu. V případě že položka zůstane nevyplněná, získáme data z clého území ČR. Naopak, pokud vybyreme území regionu a necháme prázdné políčko taxonu, získáme data všech taxonů ve vybraném regionu.

Výstupní složka

Vybereme výsupní složku kam se nám data uloží. Pokud ponecháme prázdné, stáhnou se data do složky dočasných souborů. V případě, že nechceme stahovat tabulková data zaškrtneme možnost Nestahovat tabulková data.

Stažené soubory se nahrají do projektu a ponesou název odvozený od použitého filtru a typu dat.

Příklad:

Pokud je do filtru zadán taxon, bude název odvozen od názvu druhu. Poukd filtrujeme pouze podle regionu bude název odvozen od názvu regionu.

Průběh stahování

Po potvrzení tlačítkem Ok se okno zavře a spustí se filtrace a stahování. QGIS během stahování nelze v současné době používat. Stejně jako při použití oficiálního webové filtru, stahování může trvat několik minut, v závislosti na počtu záznamů, stažení tabulkových dat atd.

V informačním panelu v horní části obrazovky uvidíte informace o průběhu stahování. Při stahování se také vypíše počet záznamů a hrubý odhad doby trvání konkrétního kroku. Po úspěšném stažení se objeví zelený panel s odkazem na složku kam byla data stažena.

Plánované funkce - zpětná vazba

Výběr plánovaných funkcí:

seznam aktuálně plánovaných funkcí zde

Pro připomínky, nápady a hlášení chyb můžete napsat email nebo použít issues projektu na GitHub .

Python balíček - ndop-downloader

Pro stahování dat lze využít nástroj příkazové řádky ndop , který se nainstaluje se zásuvným modulem do složky bin/ndop. Tento nástroj má více možností filtrů (viz nápověda modulu), a mimo jiné umožňuje stahování na základě polygonové vrstvy (vezme první polygon z vrstvy). Přihlašovací údaje lze zadat přímo do příkazu (--user, --password), nebo je načíst z konfiguračního souboru .ndop.cfg v domovském adresáři. Konfigurační soubor lze nechat vygenerovat použitím argumentu -s. Nástroj lze spustit z adresáře QGIS pluginu:

nápověda:

python3 bin/ndop -h

usage: ndop [-h] [--user USER] [--password PASSWORD] [-s] [--output OUTPUT]
            [-loc_only] [--taxon TAXON] [--region REGION] [--polygon POLYGON]
            [--month_from MONTH_FROM] [--month_to MONTH_TO]
            [--date_from DATE_FROM] [--date_to DATE_TO] [--author AUTHOR]
            [--project PROJECT] [--source SOURCE] [--d_source D_SOURCE]
            [--config CONFIG]

Download data (.csv, .shp) from NDOP based on input parametres. Unlike the
offical web filter, its possible to input polygon layer for search in area and
amount of results is not limited. Login can be stored in configuration file
".ndop.cfg".

optional arguments:
  -h, --help            show this help message and exit
  --user USER           login (user name or email)
  --password PASSWORD   ISOP password
  -s                    store login and password in "/home/ok/.ndop.cfg"
  --output OUTPUT       path with output filenames prefix
  -loc_only             downloads only spatial data without tables(faster, but
                        only localisations with id)
  --taxon TAXON         taxon name (i.e. "mantis religiosa")
  --region REGION       region of iterest (i.e. town , protected area)
  --polygon POLYGON     path to poygon layer (EPSG:5514) that define thesearch
                        area. Function takes first feature of the layer
  --month_from MONTH_FROM
                        get data only from a certain month in season (number)
  --month_to MONTH_TO   get data only to a certain month in season (number)
  --date_from DATE_FROM
                        get data from a certain date (d.m.yyyy)
  --date_to DATE_TO     get data only to a certain date (d.m.yyyy)
  --author AUTHOR       author surname and firstname (i.e. "Kaláb Oto")
  --project PROJECT     for data obtained from specific project
  --source SOURCE       general source of data (i.e. "ND - Databáze BioLog")
  --d_source D_SOURCE   specific, more detailed source of data
  --config CONFIG       path to the config file with login and password.
                        Default file path is: "/home/ok/.ndop.cfg"

Příklad použití:

python3 bin/ndop --taxon "mantis religiosa"

Python balíček lze také stánout zcela samostatně z PyPi:

pip3 install ndop-downloader

Nástroj příkazové řádky ndop

ndop -h

Příklad použití:

ndop --taxon "mantis religiosa"

Python modul

import ndop

Příklad použití:

import ndop as nd

search_payload = nd.get_search_pars()
search_payload.update({'rfTaxon':'mantis religiosa'})

# přihlašovací údaje zadáme ručně
# username = "name"
# password = "pswd"

# nebo můžeme načíst z konfiguračního souboru
username, password = nd.read_config("~/.ndop.cfg")

s = nd.login(username, password)
table_payload,num_rec = nd.search_filter(s,search_payload)

nd.get_ndop_csv_data(s,
                    num_rec,
                    table_payload,
                    "dir"
                    )

Licence

GNU General Public License v3.0

Reference

Kaláb. O. (2019): NDOP Downloader - QGIS a Python modul, OpenGeoLabs

@manual{,
  author   = {Oto Kaláb},
  title    = {NDOP Downloader - QGIS a Python modul},
  year     = {2019},
  organization = {OpenGeoLabs},
  url      = {https://github.com/OpenGeoLabs/qgis-ndop-downloader},
  keywords = {QGIS, Python, ecology, AOPK, species occurrence},
}

Pro citaci použitých dat postupujte podle Citačních pravidlel ND