DOI: 10.5281/zenodo.8171051
title: Input and output data (images + boulder labels, model setup, model weights and more) for the manuscript "Automatic characterization of boulders on planetary surfaces from high-resolution satellite images"

description: <strong>File 1:</strong> raw_data_BOULDERING.zip <strong>Size:</strong> 8.8 GB <strong>Summary: </strong>It contains all of the rasters (planetary images) and labeled boulders (raw data): a boulder-mapping file, which is the manually digitized outline of boulders. a ROM file (stands for Region of Mapping), which depicts the image patches on which the boulder mapping has been conducted. a global-tiles file, which shows all of the image patches within a raster. There are multiple locations/images per planetary body. <strong>Structure:</strong> <pre>. └── raw_data/ ├── earth/ │ └── image_name/ │ ├── shp/ │ │ ├── &lt;image_name&gt;-ROM.shp │ │ ├── &lt;image_name&gt;-boulder-mapping.shp │ │ └── &lt;image_name&gt;-global-tiles.shp │ └── raster/ │ └── &lt;image_name&gt;.tif ├── mars/ │ └── image_name/ │ ├── shp/ │ │ ├── &lt;image_name&gt;-ROM.shp │ │ ├── &lt;image_name&gt;-boulder-mapping.shp │ │ └── &lt;image_name&gt;-global-tiles.shp │ └── raster/ │ └── &lt;image_name&gt;.tif └── moon/ └── image_name/ ├── shp/ │ ├── &lt;image_name&gt;-ROM.shp │ ├── &lt;image_name&gt;-boulder-mapping.shp │ └── &lt;image_name&gt;-global-tiles.shp └── raster/ └── &lt;image_name&gt;.tif</pre> <strong>File 2:</strong> best_model.zip <strong>Size:</strong> 624.7 MB <strong>Summary:</strong> This zip file contains all of the inputs and outputs required/obtained from the training of the BoulderNet Mask R-CNN model (model setup, augmentation pipeline, model weights, log during training, logged metrics): augmentation_pipeline.json (required as inputs for the training of the algorithm to apply augmentations). See https://github.com/astroNils and the MLtools repository for more information. Base-RCNN-FPN.yaml (base model setup file). config.yaml (complete model setup file, merge of the base and Mars-Moon-Earth setup file). Mars-MoonEarth-v050...yaml (model setup file). log.txt (log during training of the algorithm). model_0055999.pth (model weights at second last saving step) model_0063999.pth (model weights at last saving step) We advice the use of model weights model_0055999.pth (to avoid slight overfitting). <strong>File 3:</strong> Apr2023-Mars-Moon-Earth-mask-5px.zip (pre-processed input images) <strong>Size:</strong> 252.8 MB <strong>Summary:</strong> This zip files contains the input data (images and boulder outlines) for the train, validation and test datasets. See https://github.com/astroNils and the MLtools repository for more information in how-to-use the different files. The json folder contains json files that can be given as input (as a custom dataset) to the Detectron2 platform. The only differences between the two files is how the bounding boxes around masks have been generated. We advised to use "Apr2023-Mars-Moon-Earth-mask-5px.json". The pkl folder and pickle file includes some informations about the 950 image patches in our boulder dataset. The pre-processing folder contains all of the training, validation and test image patches and corresponding shapefiles. The shapefile folder is actually empty (it should not be there!). <strong>Structure:</strong> <pre>. └── preprocessed_inputs/ ├── json ├── pkl ├── preprocessing/ │ ├── train/ │ │ ├── images │ │ └── labels │ ├── validation/ │ │ ├── images │ │ └── labels │ └── test/ │ ├── images │ └── labels └── shp</pre>