Getting Started
1. Download the codebase
This tutorial provides step-by-step guidance on how to set up the codebase.
First, download the codebase from our GitHub repository: https://github.com/atsu-kotani/HumanColorVision.
After downloading the codebase, you need to install the required packages.
2. Install the required packages
Using local pip
If you are using local pip, you can install the required packages by running the following command:
python -V # check the version of python (tested to work with python 3.10)
pip install -r requirements.txt
Using virtualenv
If you are using virtualenv to manage your Python environment, you can install the required packages by running the following command:
pip install virtualenv # if virtualenv is not installed
virtualenv -p python3.10 HumanColorVision # create the environment
source HumanColorVision/bin/activate # activate the environment
pip install -r requirements.txt # install the required packages
Using Conda
If you are using Conda to manage your Python environment, you can install the required packages by running the following command:
conda create --name HumanColorVision python=3.10 # create the environment
conda activate HumanColorVision # activate the environment
pip install -r requirements.txt # install the required packages
3. Check installation
To check if the installation is successful, you can run the following command from the root directory of the codebase (i.e. ./HumanColorVision/
):
python check_installation.py
If the installation is successful, you should see the following output:
**************************************************
Installation successful!
**************************************************
If you see any errors, please check the installation instructions again.
4. (Optional) Download the NTIRE dataset
If you wish to reproduce the results in the paper or train your own model using the hyperspectral image dataset, you will need to download the NTIRE 2022 dataset.
The downloaded hyperspectral image file (e.g. ARAD_1K_0001.mat
) should be placed under HumanColorVision/Dataset/NTIRE2022_original/data/
.