H5nuvola

H5nuvola Investigation

H5nuvola is a web-based HDF5 file viewer, similar to HDFView, allowing for data visualisation services and selective exporting of data with the added functionality of cloud file browsing. The back-end is based on the Python framework Flask, where the HDF5 files are accessed through h5py. The front-end uses HTML5, CSS and JavaScript.

Deployment onto local machine

You should follow the given steps to successfully deploy the application onto your local machine.

Step 1:

You must first install these pre-requisites:

Name	Version
Python	3.9
Docker	latest release
PostgreSQL	latest release

Step 2:

Clone the repository of H5nuvola to your local machine.

Step 3:

Once cloned, there are additional instructions in the README.md file located at h5nuvola\README.md. These commands should be run on the terminal to finish the setup of H5nuvola. In addition, the requirements.txt file is also available and you can run $ pip install -r requirements.txt to install the correct version of Python libraries.

Viewing HDF5 files

Firstly, the HDF5 files should be placed in a new folder called hdf5_test_files in the h5nuvola base folder and the path for this folder should be added to H5NUVOLA_BASEDIR variable in settings.py. To view the HDF5 files, you should run python3.9 manage.py runserver to launch the server after running the setup commands on the terminal. You should then be able to see the H5nuvola homepage and can select the datasets to view.