Overview

happy-tools contains several command-line utilities and graphical viewers for HSI files:

User interface tools:

• happy-data-viewer - for viewing HAPPy data folders
• happy-envi-viewer - for viewing ENVI HSI images
• happy-raw-checker - sanity checks on raw capture folders

Command-line tools:

• happy-generate-image-regions-objects - generates datasets as numpy cubes for deep learning
• happy-hdr-info - outputs information on ENVI HDR files
• happy-hsi2rbg - generates fake RGB PNG files from HSI images
• happy-mat-info - outputs Matlab struct information
• happy-ann2happy - converts OPEX JSON polygon, ENVI pixel annotations and PNG images into happy data structures
• happy-opex-labels - performs actions on OPEX JSON files that it located
• happy-plot-preproc - plots set of pixels using various preprocessors
• happy-process-data - applies a preprocessing pipeline to the data
• happy-raw-check - sanity checks on raw capture folders
• happy-scikit-regression-build - evaluates regression models on HAPPy data
• happy-scikit-segmentation-build - evaluates segmentation models on HAPPy data
• happy-scikit-unsupervised-build - evaluates cluster models on HAPPy data
• happy-splitter - for generating train/validation/test splits for HAPPy data
• happy-sub-images - for exporting annotated sub-samples into separate files

These tools are available from the Python virtual environment that they were installed. E.g., when following the installation instructions on this website, the tools would be located in the following directory in the user's home folder:

happy/bin

Overview of available plugins and their respective parameters is located here:

https://github.com/wairas/happy-tools/blob/main/plugins/README.md