Skip to content

brazil-data-cube/sample-db-utils

Repository files navigation

Utility Functions for the SAMPLE-DB

Software License Build Status Code Coverage Test Documentation Status Software Life Cycle Release Join us at Discord

About

Currently, several projects systematically provide information on the dynamics of land use and cover. Well known projects include PRODES, DETER and TerraClass. These projects are developed by INPE and they produce information on land use and coverage used by the Brazilian Government to make public policy decisions. Besides these projects there are other initiatives from universities and space agencies devoted to the creation of national and global maps.

These data products are generated using different approaches and methodologies. In this context, the data set used in the sample and validation plays a fundamental role in the classification algorithms that generate new land use and coverage maps. A classified map’s accuracy depends directly on the quality of the training samples used by the machine learning methods.

Land use and cover samples are collected by different projects and individuals, using different methods, such as in situ gathering in fieldwork and visual interpretation of high-resolution satellite images. An important requirement is to be able to describe samples with proper metadata that characterize their differences and organize them in a shared database to facilitate the reproducibility of experiments. It is also important to develop tools to easily discover, query, access, and process this shared sample database.

Sample-DB (Sample Database) provides a data model that represents the land use and cover samples collected by different projects and individuals. SAMPLE-DB-UTILS, has the utility functions that perform the transformation of different data formats to be stored by SAMPLE-DB.

This package is related to other softwares in the Brazil Data Cube project. For more information on SAMPLE-DB-UTILS, see:

  • SAMPLE-DB: Sample Database Model.
  • SAMPLE.py: Python client library over a WFS endpoint for retrieving samples.
  • LCCS-DB: Land Cover Classification System Database Model.
  • LCCS-WS-SPEC: Land Cover Classification System Web Service specification.
  • LCCS-WS: Land Cover Classification System Web Service implementation.
  • LCCS.py: Python Client Library for Land Cover Classification System Web Service.

Installation

See INSTALL.rst.

License

Copyright (C) 2020-2021 INPE.

SAMPLE-DB is a free software; you can redistribute it and/or modify it under the terms of the MIT License; see LICENSE file for more details.