Skip to content
Museo ToolBox : a python library for remote sensing scripts
Python Other
  1. Python 98.2%
  2. Other 1.8%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples fix wrong library in doc Feb 10, 2020
museotoolbox Enhance paper as recommended by @cmillion, issue #19 Feb 10, 2020
test modify RasterMath, enhance _process_block Feb 9, 2020
.coveragerc prep v1.7rc1 Nov 25, 2019
.environment.yml Update .environment.yml Sep 9, 2019
.readthedocs.yml Update .readthedocs.yml Sep 9, 2019
.travis.yml update travis file Dec 6, 2019 v12.1 beta 2 Feb 9, 2020
CONTRIBUTING.rst update paper Dec 12, 2019
Makefile add tests and change raster_tools/vector_tools to geo_tools Nov 26, 2019 v1.5.3, enhance getSamplesFromROI to have only raster values Oct 1, 2019
paper.bib Enhance paper as recommended by @cmillion, issue #19 Feb 10, 2020 Enhance paper as recommended by @cmillion, issue #19 Feb 10, 2020
requirements-dev.txt v2.0b1 Dec 8, 2019
requirements.txt Update requirements.txt Sep 5, 2019 update doc and add retrieve yp and yr from confusion matrix Nov 26, 2019

Museo ToolBox logo

Build status Documentation status codecov PyPI version Downloads DOI

Museo ToolBox is a python library to simplify the use of raster/vector, especially for machine learning and remote sensing. It is now easy to extract raster values from vector polygons and to do some spatial/unspatial cross-validation for scikit-learn from raster.

One of the most meaningful contribution is, in my humble opinion, the RasterMath.

Using and citing the toolbox

If you use Museo ToolBox in your research and find it useful, please cite this library using the following bibtex reference:

title={Museo ToolBox : a python library for remote sensing},
author={Karasiak Nicolas},

What's the point ?

Today, the main usages of Museo ToolBox are :

  • museotoolbox.cross_validation
    • Create validation/training sets from vector, and cross-validation compatible with Scikit-Learn GridSearchCV. The aim is here to promote the spatial cross-validation in order to better estimate a model (with a lower spatial auto-correlation overestimation).
  • museotoolbox.processing
    • RasterMath, allows you to apply any of your array-compatible function on your raster and save it. Just load RasterMath, then it will return you the value for each pixel (in all bands) and now you can do whatever you want : predicting a model, smooth signal (whittaker, double logistic...), compute modal value... RasterMath reads and writes a raster block per block to avoid loading the full image in memory. It is compatible with every python function (including numpy) as the first and only argument RasterMath needs on your function is an array.
    • Extract bands values from vector ROI (polygons/points) (function : extract_ROI)
  • AI based on Scikit-Learn. SuperLearner simplifies the use of cross-validation by extracting each accuracy (kappa,F1,OA, and above all confusion matrix) from each fold. It also eases the way to predict a raster (just give the raster name and the model).

That seems cool, but is there some help to use this ?

I imagined Museo ToolBox as a tool to simplify raster processing and to promote spatial cross-validation, so of course there is some help : a complete documentation with a lot of examples is available on readthedocs.

I want to improve Museo ToolBox, how can I contribute ?

To contribute to this package, please read the instructions in CONTRIBUTING.rst.

How do I install it ?

A package is available on pip :

python3 -m pip install museotoolbox --user

For early-adopters, you can install the latest development version directly from git :

python3 -m pip install --user

Feel free to remove the --user if you like to install the library for every user on the machine.

Who built Museo ToolBox ?

I am Nicolas Karasiak, a Phd student at Dynafor Lab. I work tree species mapping from space throught dense satellite image time series, especially with Sentinel-2. A special thanks goes to Mathieu Fauvel who initiated me to the beautiful world of the open-source.

Why this name ?

As Orfeo ToolBox is one my favorite and most useful library to work with raster data, I choose to name my work as Museo because in ancient Greek religion and myth, Museo is the son and disciple of Orfeo. If you want an acronym, let's say MUSEO means 'Multiple Useful Services for Earth Observation'.

You can’t perform that action at this time.