lsdviztools


Namelsdviztools JSON
Version 0.4.14 PyPI version JSON
download
home_pagehttps://github.com/LSDTopotools/lsdviztools
Summarylsdviztools is a collection of routines for plotting geospatial data, with a focus on data produces by LSDTopoTools or by lsdtopytools.
upload_time2024-11-22 18:40:14
maintainerNone
docs_urlNone
authorSimon Marius Mudd
requires_python>=3.6
licenseMIT
keywords lsdviztools lsdtopotools lsdtopytools gis topographic analysis remote sensing geomorphology earth observation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            ===============
lsdviztools
===============


.. image:: https://img.shields.io/pypi/v/lsdviztools.svg?branch=master
        :target: https://pypi.org/project/lsdviztools/


lsdvizools is a collection of routines for plotting geospatial data, with a focus on data produced by LSDTopoTools or by lsdtopytools.


* Free software: MIT license
* Documentation: https://lsviztools.readthedocs.io.


Features
--------

* Plotting of rasters that includes formatting so you can get publication-ready figures with one command.
* Selection of basins and channels for topographic analysis.
* Tools for plotting point data, usually associated with channel networks, derived from LSDTopoTools command line tools.
* Downloading of data from opentopography,org


Examples
--------

Multiple examples can be found in the form of python notebooks located here: https://github.com/LSDtopotools/lsdtt_notebooks 

These notebooks can be opened using google colaboratory, only a functioning web browser is required. 

Getting started
---------------

You can install lsdviztools with pip.

You can also use our docker container (in the second command you need to change the path after -v to your local directory). You first need to install docker: https://www.docker.com/products/docker-desktop

::

  $ docker pull lsdtopotools/lsdtt_pytools_docker

  $ docker run -it -v /path/to/my/local/directory:/LSDTopoTools -p 8888:8888 lsdtopotools/lsdtt_pytools_docker

  # jupyter notebook --ip 0.0.0.0 --port 8888 --no-browser --allow-root

Then go to the jupyter notebook in your web browser by going to http://localhost:8888/




Credits
-------

This package was written by Simon M. Mudd, Fiona J. Clubb and Stuart W.D. Grieve

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.1.0 (2020-05-01)
------------------

* First release on PyPI.

0.2.0 (2020-06-16)
------------------

* Minor bug fixes

0.3.0 (2020-09-03)
------------------

* Minor bug fixes

0.4.0 (2021-02-03)
------------------

* Updated opentopography API and fixed chi mapping interface

0.4.4 (2021-03-02)
------------------

* Fixed a bug in the projection section of gdalio. Trying to make the code more resistent to errors generate by different versions of proj


0.4.5 (2021-07-22)
------------------

This release of lsdviztools adds some command line scripts for plotting basic rasters, chi analysis and concavity analysis.
It also adds functionality for using the opentopography API, including downloading of data using the API key, so it includes, for example, the copernicus DEMs.
It also fixes a bug with gdal that made up a pull request.


0.4.6 (2021-07-23)
------------------

Minor update that includes changes to make sure scripts run.

The four scripts are

* lsdtt_plotbasicmetrics for basic plotting
* lsdtt_plotchianalysis for channel profile analysis and tectonic geomorphology
* lsdtt_plotconcavityanalysis for concavity analysis of river profiles
* lsdtt_grabopentopographydata for grabbing data from opentopography.org


0.4.7 (2021-08-27)
------------------

Some fixes

* For scripts a fix to make sure you have the correct directory without the -dir flag
* A fix to the opentopography api key
* An update to the opentopography scraper that allows lower lef and upper right corners to be easily copied from google maps

0.4.8 (2022-09-15)
------------------

Some fixes

* More fixes to the opentopography grabber
* This uses an api key in a file now

0.4.9 (2022-12-13)
------------------

Some fixes

* Added the lsdtt-valley-metrics to the driver interface
* Added point mapping to the plotting tools
* A number of bug fixes to the command line interface


0.4.10 (2023-03-10)
-------------------

Some fixes

* Added the descartes dependency
* Small change to the swath plotting routine

0.4.11 (2023-03-27)
-------------------

Important fix

* Removed descartes dependency and switched this to a direct plotting routine. This fixes an error caused by transition to python 3.9 in google colab

0.4.12 (2024-02-09)
-------------------

* Trying to solve a weird problem with conversion to UTM
* Making hiding API key for opentopography
* Fixing another descartes problem

0.4.13 (2024-10-09)
-------------------

* Sorting out another hidden UTM issue. Ensures a single digit UTM is processed correctly.
* Sorting out another hidden UTM issue. Ensures a single digit UTM is processed correctly.
* Updated the list of datasets available from opentopography
* You can now download USGS data

0.4.14 (2024-11-22)
-------------------

* Slight adjustment to the csv ingestion in the rasterisation tools
* Updates to the basemaps. New functions to make and orthographic basemap and a large regional hillshade
* More flexibility in the points over hillshade function
* Added the scalebar option to a number of plot types


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/LSDTopotools/lsdviztools",
    "name": "lsdviztools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": "lsdviztools, lsdtopotools, lsdtopytools, GIS, topographic analysis, remote sensing, geomorphology, earth observation",
    "author": "Simon Marius Mudd",
    "author_email": "simon.m.mudd@ed.ac.uk",
    "download_url": "https://files.pythonhosted.org/packages/96/9c/ca4145c58fc4e9f31d9c83921a787b647a15f89d044fcbb1d44452784616/lsdviztools-0.4.14.tar.gz",
    "platform": null,
    "description": "===============\nlsdviztools\n===============\n\n\n.. image:: https://img.shields.io/pypi/v/lsdviztools.svg?branch=master\n        :target: https://pypi.org/project/lsdviztools/\n\n\nlsdvizools is a collection of routines for plotting geospatial data, with a focus on data produced by LSDTopoTools or by lsdtopytools.\n\n\n* Free software: MIT license\n* Documentation: https://lsviztools.readthedocs.io.\n\n\nFeatures\n--------\n\n* Plotting of rasters that includes formatting so you can get publication-ready figures with one command.\n* Selection of basins and channels for topographic analysis.\n* Tools for plotting point data, usually associated with channel networks, derived from LSDTopoTools command line tools.\n* Downloading of data from opentopography,org\n\n\nExamples\n--------\n\nMultiple examples can be found in the form of python notebooks located here: https://github.com/LSDtopotools/lsdtt_notebooks \n\nThese notebooks can be opened using google colaboratory, only a functioning web browser is required. \n\nGetting started\n---------------\n\nYou can install lsdviztools with pip.\n\nYou can also use our docker container (in the second command you need to change the path after -v to your local directory). You first need to install docker: https://www.docker.com/products/docker-desktop\n\n::\n\n  $ docker pull lsdtopotools/lsdtt_pytools_docker\n\n  $ docker run -it -v /path/to/my/local/directory:/LSDTopoTools -p 8888:8888 lsdtopotools/lsdtt_pytools_docker\n\n  # jupyter notebook --ip 0.0.0.0 --port 8888 --no-browser --allow-root\n\nThen go to the jupyter notebook in your web browser by going to http://localhost:8888/\n\n\n\n\nCredits\n-------\n\nThis package was written by Simon M. Mudd, Fiona J. Clubb and Stuart W.D. Grieve\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n=======\nHistory\n=======\n\n0.1.0 (2020-05-01)\n------------------\n\n* First release on PyPI.\n\n0.2.0 (2020-06-16)\n------------------\n\n* Minor bug fixes\n\n0.3.0 (2020-09-03)\n------------------\n\n* Minor bug fixes\n\n0.4.0 (2021-02-03)\n------------------\n\n* Updated opentopography API and fixed chi mapping interface\n\n0.4.4 (2021-03-02)\n------------------\n\n* Fixed a bug in the projection section of gdalio. Trying to make the code more resistent to errors generate by different versions of proj\n\n\n0.4.5 (2021-07-22)\n------------------\n\nThis release of lsdviztools adds some command line scripts for plotting basic rasters, chi analysis and concavity analysis.\nIt also adds functionality for using the opentopography API, including downloading of data using the API key, so it includes, for example, the copernicus DEMs.\nIt also fixes a bug with gdal that made up a pull request.\n\n\n0.4.6 (2021-07-23)\n------------------\n\nMinor update that includes changes to make sure scripts run.\n\nThe four scripts are\n\n* lsdtt_plotbasicmetrics for basic plotting\n* lsdtt_plotchianalysis for channel profile analysis and tectonic geomorphology\n* lsdtt_plotconcavityanalysis for concavity analysis of river profiles\n* lsdtt_grabopentopographydata for grabbing data from opentopography.org\n\n\n0.4.7 (2021-08-27)\n------------------\n\nSome fixes\n\n* For scripts a fix to make sure you have the correct directory without the -dir flag\n* A fix to the opentopography api key\n* An update to the opentopography scraper that allows lower lef and upper right corners to be easily copied from google maps\n\n0.4.8 (2022-09-15)\n------------------\n\nSome fixes\n\n* More fixes to the opentopography grabber\n* This uses an api key in a file now\n\n0.4.9 (2022-12-13)\n------------------\n\nSome fixes\n\n* Added the lsdtt-valley-metrics to the driver interface\n* Added point mapping to the plotting tools\n* A number of bug fixes to the command line interface\n\n\n0.4.10 (2023-03-10)\n-------------------\n\nSome fixes\n\n* Added the descartes dependency\n* Small change to the swath plotting routine\n\n0.4.11 (2023-03-27)\n-------------------\n\nImportant fix\n\n* Removed descartes dependency and switched this to a direct plotting routine. This fixes an error caused by transition to python 3.9 in google colab\n\n0.4.12 (2024-02-09)\n-------------------\n\n* Trying to solve a weird problem with conversion to UTM\n* Making hiding API key for opentopography\n* Fixing another descartes problem\n\n0.4.13 (2024-10-09)\n-------------------\n\n* Sorting out another hidden UTM issue. Ensures a single digit UTM is processed correctly.\n* Sorting out another hidden UTM issue. Ensures a single digit UTM is processed correctly.\n* Updated the list of datasets available from opentopography\n* You can now download USGS data\n\n0.4.14 (2024-11-22)\n-------------------\n\n* Slight adjustment to the csv ingestion in the rasterisation tools\n* Updates to the basemaps. New functions to make and orthographic basemap and a large regional hillshade\n* More flexibility in the points over hillshade function\n* Added the scalebar option to a number of plot types\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "lsdviztools is a collection of routines for plotting geospatial data, with a focus on data produces by LSDTopoTools or by lsdtopytools.",
    "version": "0.4.14",
    "project_urls": {
        "Homepage": "https://github.com/LSDTopotools/lsdviztools"
    },
    "split_keywords": [
        "lsdviztools",
        " lsdtopotools",
        " lsdtopytools",
        " gis",
        " topographic analysis",
        " remote sensing",
        " geomorphology",
        " earth observation"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a314286c818ad50340acaae94c2afbdb94934a165f284f874c2951846207fd6e",
                "md5": "30d176e57867011d7d7ff43d9bc6c1d1",
                "sha256": "4b58e22f77425fff2b4c06cd10b30c3ec9835b4d18ef7f33dec35490e8788d39"
            },
            "downloads": -1,
            "filename": "lsdviztools-0.4.14-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "30d176e57867011d7d7ff43d9bc6c1d1",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.6",
            "size": 272536,
            "upload_time": "2024-11-22T18:40:11",
            "upload_time_iso_8601": "2024-11-22T18:40:11.852356Z",
            "url": "https://files.pythonhosted.org/packages/a3/14/286c818ad50340acaae94c2afbdb94934a165f284f874c2951846207fd6e/lsdviztools-0.4.14-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "969cca4145c58fc4e9f31d9c83921a787b647a15f89d044fcbb1d44452784616",
                "md5": "fe3976613d6b17b7a6b7db6547d30049",
                "sha256": "e60912d61bc834359111c88e9b7808665006c568556f1c1ab1219cbd421d3878"
            },
            "downloads": -1,
            "filename": "lsdviztools-0.4.14.tar.gz",
            "has_sig": false,
            "md5_digest": "fe3976613d6b17b7a6b7db6547d30049",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 9131023,
            "upload_time": "2024-11-22T18:40:14",
            "upload_time_iso_8601": "2024-11-22T18:40:14.995702Z",
            "url": "https://files.pythonhosted.org/packages/96/9c/ca4145c58fc4e9f31d9c83921a787b647a15f89d044fcbb1d44452784616/lsdviztools-0.4.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-22 18:40:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "LSDTopotools",
    "github_project": "lsdviztools",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": false,
    "tox": true,
    "lcname": "lsdviztools"
}
        
Elapsed time: 0.45257s