Science Score: 62.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org, zenodo.org
  • Academic email domains
  • Institutional organization owner
    Organization big-data-lab-umbc has institutional domain (bdal.umbc.edu)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.2%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: big-data-lab-umbc
  • License: apache-2.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 338 MB
Statistics
  • Stars: 3
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created over 4 years ago · Last pushed over 3 years ago
Metadata Files
Readme License Citation

README.md

Bathymetry Super Resolution

DOI

Table of contents

Architecture

The bathymetry super resolution model is based on a pre-trained SR-ResNet model to generate remote-sensing images with higher resolution than the original ones with limited training dataset. First we pretrain a SR-ResNet model by Large-scale CelebFaces Attributes (CelebA) Dataset which contains 202,599 JPEG images. Then we use transfer learning to adapt our bathymetry dataset composed of 2000 Tiff images selected from ETOPO-1 dataset.) and GEBCO dataset, with fine tuning on the last layer of the model. Finally the model is used to generate high-resolution images for any Tiff inputs. Both the pretrained model and bathymetry model are developed using python API and libraries of PyTorch. The figure below illustrated the overall architecture of our bathymetry super resolution model.

archi

Downloading Datasets

  • ##### Download Celeb-A datasets for Pre-training:

The dataset is public and can be downloaded at the official website. Unzip the folder as 'imgalignceleba' at the data folder.

  • ##### Download training set for bathymetry training:

The images for training set of our work are manually cropped from ETOPO-1 and GEBCO grid datasets. Please download and unzip in 'data/train': https://drive.google.com/file/d/1ZwW2sGMgVgya-vDHF5xViM2pa0ziapUF/view?usp=share_link.

  • ##### Download test set for testing:

The images for test set of our work are manually cropped from ETOPO-1 and GEBCO grid datasets. Please download and unzip in 'data/test': https://drive.google.com/file/d/16IoRbHVasGl07ZRrQIq11l6eop7Na3d/view?usp=sharelink

Training and Testing

Installation

$ git clone https://github.com/big-data-lab-umbc/bathymetry_super_resolution $ cd bathymetry_super_resolution/ $ sudo pip3 install -r requirements.txt

Training

  • ##### Pre-training

We use transfer learning to gain some knowledge of super resolution from RGB images because we have only limited training samples. To implement the transfer learning based super resolution for Bathymetry data, we use a pre-training and fine-tuning approach. In particular, transfer learning with the help of a large-scale CelebFaces Attributes dataset is first performed for the external learning of backbone structure and mapping.

Please refer to README in pre-training folder for training steps.

  • ##### Bathymetry training

In bathymetry training process, our customized loss functions are combinations of some or all of three parts: content loss, water loss and coastal loss. We have 5 models of different combinations:

  • Model 1: content loss
  • Model 2: content loss + water loss
  • Model 3: water loss
  • Model 4: water loss + coastal loss
  • Model 5: coastal loss

Please refer to README in Bathymetry training folder for training steps.

Testing

The saved trained model by bathymetry training can be used to generate high-resolution images. Load the saved .pth file into generator to test the saved model.

Results

The test images are evaluated by MSE, PSNR and SSIM on the whole area, ocean area and coastal area, respectively. Please use codes in evaluation folder.

The image below illustrates the visual comparison among different experiments and ground truth at the same location. From (a) to (j) are original low-resolution image, bi-cubic interpolation (baseline 1), pre-trained model (baseline 2), directly-trained model (baseline 2), model 1 (content loss), model 2 (content + water loss), model 3 (water loss). model 4 (water + coastal loss), model 5 (coastal loss) and original high-resolution image (ground truth). Among all the experiments, model 5 (coastal loss) is the best model we have. The area in white color has positive pixel values and represents land area, the black area represents deep ocean and the area in grey and around land area represents coastal area.

cb589411047fb6475159e92caba37fc

Credit

Our work is designed to conduct super resolution of bathymetry data based on theories and network architecture proposed by paper of SR-GAN: Photo-Realistic Single Image Super-Resolution Using a Generative Adversarial Network. We developed based on a PyTorch version implementation published at Github repository. The detailed information is as below.

Photo-Realistic Single Image Super-Resolution Using a Generative Adversarial Network

Authors

Christian Ledig, Lucas Theis, Ferenc Huszar, Jose Caballero, Andrew Cunningham, Alejandro Acosta, Andrew Aitken, Alykhan Tejani, Johannes Totz, Zehan Wang, Wenzhe Shi

[Paper]

PyTorch-GAN Github Repository

Author: eriklindernoren

[Repository]

Owner

  • Name: Big Data Analytics Lab @ UMBC
  • Login: big-data-lab-umbc
  • Kind: organization
  • Location: University of Maryland, Baltimore County

Citation (CITATION.cff)

# YAML 1.2
# Metadata for citation of this software according to the CFF format (https://citation-file-format.github.io/)
cff-version: 1.0.3
message: If you use this software, please cite it using these metadata.
# FIXME title as repository name might not be the best name, please make human readable
title: 'Enhanced Deep Learning Super-Resolution for Bathymetry Data'
doi: 10.5281/zenodo.7275300
# FIXME splitting of full names is error prone, please check if given/family name are correct
authors:
- given-names: Xingyan
  family-names: Li
  email: sj51939@umbc.edu
- given-names: Jianwu
  family-names: Wang
  email: jianwu@umbc.edu
- given-names: Jian
  family-names: Li
  email: jian.li@nasa.gov
version: 1.0.0
date-released: 2022-11-03
repository-code: https://github.com/big-data-lab-umbc/bathymetry_super_resolution
license: other-open

GitHub Events

Total
Last Year

Dependencies

requirements.txt pypi
  • matplotlib *
  • numpy *
  • pillow *
  • rasterio *
  • scikit-image *
  • scipy *
  • torch >=0.4.0
  • torchvision *
  • urllib3 *