dhdt

Extracting topography from mountain glaciers, through the use of shadow casted by surrounding mountains.

https://github.com/go-eratosthenes/dhdt

Keywords

Repository

Extracting topography from mountain glaciers, through the use of shadow casted by surrounding mountains.

README.rst

|GitHub Badge| |License Badge| |Python Build| |Documentation Status| |OpenSSF Best Practices|

.. |GitHub Badge| image:: https://img.shields.io/badge/github-repo-000.svg?logo=github&labelColor=gray&color=blue
   :target: https://github.com/GO-Eratosthenes/eratosthenes
   :alt: GitHub Badge

.. |License Badge| image:: https://img.shields.io/github/license/GO-Eratosthenes/start-code
   :target: https://github.com/GO-Eratosthenes/start-code
   :alt: License Badge

.. |Python Build| image:: https://github.com/GO-Eratosthenes/start-code/workflows/Build/badge.svg
   :target: https://github.com/GO-Eratosthenes/start-code/actions?query=workflow%3A%22build.yml%22
   :alt: Python Build
   
.. |Documentation Status| image:: https://readthedocs.org/projects/dhdt/badge/?version=latest
   :target: https://dhdt.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. |OpenSSF Best Practices| image:: https://bestpractices.coreinfrastructure.org/projects/7641/badge
   :target: https://bestpractices.coreinfrastructure.org/projects/7641
   :alt: OpenSSF Best Practices

############
dhdt
############

Extracting topography from mountain glaciers, through the use of shadow casted by surrounding mountains. Imagery from optical satellite systems are used, over all mountain ranges on Earth.


Installation
************

Download and access the package folder using `git`:

.. code-block:: console

  git clone https://github.com/GO-Eratosthenes/dhdt.git
  cd dhdt


The dependencies are most easily installed with `conda` from the `conda-forge` channel (see `Miniforge installers`_ for a minimal Conda installation).
Create and activate a virtual environment with all the required dependencies:

.. code-block:: console

  conda env create -n dhdt -f environment.yml
  conda activate dhdt


Install `dhdt` using `pip` (add the `-e` option to install in development mode):

.. code-block:: console

  pip install .

.. _Miniforge installers : https://github.com/conda-forge/miniforge/releases

Contributing
************

If you want to contribute to the development of this package,
have a look at the `contribution guidelines `_.

License
*******

Copyright (c) 2023, Netherlands eScience Center, Utrecht University

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Credits
*******

This package was created with `Cookiecutter `_ and the `NLeSC/python-template `_.

Owner

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: >-
  dhdt: A photohypsometric Python library to estimate
  glacier elevation change via optical remote sensing
  imagery
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - family-names: Altena
    given-names: Bas
    orcid: 'https://orcid.org/0000-0001-9025-0326'
    affiliation: >-
      Institute for Marine and Atmospheric research (IMAU),
      Department of Physics, Faculty of Science, Utrecht
      University & Space Accountants
    city: Utrecht
    country: NL
    email: b.altena@uu.nl
  - given-names: Francesco
    family-names: Nattino
    email: f.nattino@esciencecenter.nl
    affiliation: Netherlands eScience Center
    city: Amsterdam
    country: NL
    orcid: 'https://orcid.org/0000-0003-3286-0139'
repository-code: 'https://github.com/GO-Eratosthenes/dhdt'
url: 'https://dhdt.readthedocs.io'
abstract: >-
  dhdt is a modular geodetic imaging framework written in
  Python. It uses data from imaging satellites to extract
  (above) surface kinematics and elevation (change). This is
  done via image matching techniques and geometric
  principles.
keywords:
  - Python
  - glacier elevation change
  - optical remote sensing
  - geodetic imaging
  - feature tracking
license: Apache-2.0
version: 0.1.0
# date-released: '2023-XX-XX'  # update before first release
# doi: '10.5281/zenodo.0000000'  # update after first release

GitHub Events