geoextent

Python library for extrating geospatial extent of files and directories with multiple data formats

https://github.com/o2r-project/geoextent

Science Score: 77.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
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    2 of 6 committers (33.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.8%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Python library for extrating geospatial extent of files and directories with multiple data formats

Basic Info
  • Host: GitHub
  • Owner: o2r-project
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage: https://o2r.info/geoextent/
  • Size: 17 MB
Statistics
  • Stars: 2
  • Watchers: 3
  • Forks: 5
  • Open Issues: 56
  • Releases: 4
Created over 6 years ago · Last pushed about 2 years ago
Metadata Files
Readme Contributing License Citation Authors Codemeta

README.md

geoextent

Python package Build Status PyPI version Binder Project Status: Active – The project has reached a stable, usable state and is being actively developed. DOI SWH SWH

Python library for extracting geospatial extent of files and directories with multiple data formats. Read a notebook-based article about the library published at EarthCube 2021.

This project is developed as part of the DFG-funded research project Opening Reproducible Research (o2r, https://o2r.info).

Installation

System requirements

Python: 3.x

The package relies on common system libraries for reading geospatial datasets, such as GDAL and NetCDF. On Debian systems, the UbuntuGIS project offers easy installation of up to date versions of those libraries.

See the packages list in travis.yml for a full list of dependencies on Linux.

Install from PyPI

You must install a suitable version of pygdal manually first, see instructions and this related SO thread with different helpful answers. We use pygdal for better compatibility with virtual environments.

bash pip install pygdal=="`gdal-config --version`.*" pip install geoextent

Source installation

```bash git clone https://github.com/o2r-project/geoextent cd geoextent pip install -r requirements.txt

pip install -e . ```

Use

Run

bash geoextent --help

to see usage instructions.

Showcases

Binder

To run the showcase notebooks, install JupyterLab or the classic Jupyter Notebook and then start a local server as shown below. If your IDE has support for the Jupyter format, installing ipykernel might be enough. We recommend running the below commands in a virtual environment as described here. The notebook must be trusted and python-markdown extension must be installed so that variables within Markdown text can be shown.

```bash cd showcase pip install -r requirements.txt pip install -r showcase/requirements.txt pip install -e .

jupyter trust showcase/SG01ExploringResearchDataRepositorieswith_geoextent.ipynb jupyter lab ```

Then open the local Jupyter Notebook server using the displayed link and open the notebook (*.ipynb files) in the showcase/ directory. Consult the documentation on paired notebooks based on Jupytext before editing selected notebooks.

Supported data formats

  • GeoJSON (.geojson)
  • Tabular data (.csv)
  • Shapefile (.shp)
  • GeoTIFF (.geotiff, .tif)

Contribute

All help is welcome: asking questions, providing documentation, testing, or even development.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

See CONTRIBUTING.md for details.

How to cite

Nüst, Daniel; Garzón, Sebastian and Qamaz, Yousef. (2021, May 14). o2r-project/geoextent (Version v0.7.1). Zenodo. https://zenodo.org/record/4762205

See also the CITATION.cff and codemeta.json files in this repository, which can possibly be imported in the reference manager of your choice.

License

geoextent is licensed under MIT license, see file LICENSE.

Copyright (C) 2020 - o2r project.

Owner

  • Name: Opening Reproducible Research
  • Login: o2r-project
  • Kind: organization
  • Email: daniel.nuest@uni-muenster.de
  • Location: Münster

Citation (CITATION.cff)

cff-version: 1.1.0
message: If you use this software, please cite it as below.
authors:
  - family-names: Nüst
    given-names: Daniel
    orcid: https://orcid.org/0000-0002-0024-5046
    affiliation: Opening Reproducible Research, University of Münster, Münster, Germany
    email: daniel.nuest@uni-muenster.de
    website: https://nuest.staff.ifgi.de/
  - family-names: Garzón
    given-names: Sebastian
    orcid: https://orcid.org/0000-0002-8335-9312
    affiliation: Opening Reproducible Research, University of Münster, Münster, Germany
    email: jgarzon@uni-muenster.de

  - family-names: Qamaz
    given-names: Yousef
title: "geoextent"
version: 0.7.1
doi: 10.5281/zenodo.3925693
date-released: 2020-05-11
license: MIT
url: https://o2r.info/geoextent/
commit: 7edce80ba937796ea6563d2e7ab6d800ec48bc7c
abstract: "Python library for extracting geospatial extent of files and directories with multiple data formats. This project is developed as part of the DFG-funded research project Opening Reproducible Research (o2r, https://o2r.info)."
repository-artifact: https://pypi.org/project/geoextent/0.3.0/
repository-code: https://github.com/o2r-project/geoextent/releases/tag/v0.3.0
identifiers:
  - type: "swh"
    value: "swh:1:rev:7edce80ba937796ea6563d2e7ab6d800ec48bc7c"

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "license": "https://spdx.org/licenses/MIT",
  "codeRepository": "git+https://github.com/o2r-project/geoextent.git",
  "contIntegration": "https://travis-ci.org/github/o2r-project/geoextent",
  "dateCreated": "2019-08-16",
  "datePublished": "2020-03-25",
  "dateModified": "2020-05-11",
  "downloadUrl": "https://pypi.org/project/geoextent/0.7.1/",
  "issueTracker": "https://github.com/o2r-project/geoextent/issues",
  "name": "geoextent",
  "version": "0.7.1",
  "identifier": "https://doi.org/10.5281/zenodo.3925693",
  "description": "Python library for extracting geospatial extent of files and directories with multiple data formats. This project is developed as part of the DFG-funded research project Opening Reproducible Research (o2r, https://o2r.info).",
  "applicationCategory": "Geoinformatics",
  "funding": "PE 1632/17-1",
  "developmentStatus": "active",
  "isPartOf": "https://o2r.info/",
  "funder": {
    "@type": "Organization",
    "name": "DFG"
  },
  "keywords": [
    "spatial data",
    "metadata",
    "discovery"
  ],
  "programmingLanguage": [
    "Python 3"
  ],
  "operatingSystem": [
    "OS independent"
  ],
  "relatedLink": [
    "https://o2r.info/geoextent/"
  ],
  "author": [
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0002-0024-5046",
      "givenName": "Daniel",
      "familyName": "Nst",
      "email": "daniel.nuest@uni-muenster.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Opening Reproducible Research, University of Mnster, Mnster, Germany"
      }
    },
    {
      "@type": "Person",
      "@id": "https://orcid.org/0000-0002-8335-9312",
      "givenName": "Sebastian",
      "familyName": "Garzn",
      "email": "jgarzon@uni-muenster.de",
      "affiliation": {
        "@type": "Organization",
        "name": "Opening Reproducible Research, University of Mnster, Mnster, Germany"
      }
    },
    {
      "@type": "Person",
      "givenName": "Yousef",
      "familyName": "Qamaz",
      "affiliation": {
        "@type": "Organization",
        "name": "Opening Reproducible Research, University of Mnster, Mnster, Germany"
      }
    }
  ]
}

GitHub Events

Total
  • Issues event: 2
  • Fork event: 1
Last Year
  • Issues event: 2
  • Fork event: 1

Committers

Last synced: almost 3 years ago

All Time
  • Total Commits: 417
  • Total Committers: 6
  • Avg Commits per committer: 69.5
  • Development Distribution Score (DDS): 0.592
Top Committers
Name Email Commits
YouQam q****f@g****m 170
sbastiangarzon j****8@u****o 132
Daniel Nüst d****t@u****e 84
Yousef y****f@g****e 15
Yousef Qamaz 4****m@u****m 11
Daniel Nüst d****t@w****e 5
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 87
  • Total pull requests: 21
  • Average time to close issues: 5 months
  • Average time to close pull requests: 11 days
  • Total issue authors: 3
  • Total pull request authors: 3
  • Average comments per issue: 0.85
  • Average comments per pull request: 0.43
  • Merged pull requests: 17
  • Bot issues: 0
  • Bot pull requests: 2
Past Year
  • Issues: 4
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • nuest (70)
  • SbastianGarzon (12)
  • YouQam (5)
Pull Request Authors
  • SbastianGarzon (14)
  • nuest (6)
  • dependabot[bot] (2)
Top Labels
Issue Labels
enhancement (44) documentation (8) raster (7) vector (7) bug (5) question (2) good first issue (2) help wanted (1)
Pull Request Labels
dependencies (2) documentation (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 14 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 5
  • Total maintainers: 3
pypi.org: geoextent

A package to extract geospatial extent from files and directories

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 14 Last month
Rankings
Dependent packages count: 10.1%
Forks count: 15.4%
Dependent repos count: 21.6%
Average: 21.9%
Downloads: 30.3%
Stargazers count: 31.9%
Maintainers (3)
Last synced: 6 months ago

Dependencies

docs/requirements-docs.txt pypi
  • jupyter_sphinx *
  • sphinx-issues *
  • sphinxcontrib.autoprogram *
requirements-dev.txt pypi
  • pytest >=5 development
  • pytest-console-scripts * development
  • wheel * development
requirements.txt pypi
  • geojson >=2.4.1
  • numpy *
  • pandas *
  • pygeoj *
  • pyproj *
  • pyshp *
  • python-dateutil *
  • requests *
  • traitlets *
setup.py pypi
  • geojson >=2.4.1
  • numpy *
  • pandas *
  • pygdal *
  • pygeoj *
  • pyproj *
  • pyshp *
  • python-dateutil *
  • requests *
  • traitlets *
  • wheel *
showcase/requirements.txt pypi
  • bash_kernel *
  • folium ==0.11.0
  • geopandas ==0.8.1
  • jupyterlab *
  • matplotlib ==3.3.2
  • numpy ==1.19.5
  • pandas ==1.1.2
  • requests ==2.24.0
  • shapely ==1.7.1
.github/workflows/codeql-analysis.yml actions
  • actions/checkout v2 composite
  • github/codeql-action/analyze v1 composite
  • github/codeql-action/autobuild v1 composite
  • github/codeql-action/init v1 composite
.github/workflows/documentation.yml actions
  • JamesIves/github-pages-deploy-action 4.1.3 composite
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
.github/workflows/pythonpackage.yml actions
  • actions/checkout v1 composite
  • actions/setup-python v1 composite
Dockerfile docker
  • ubuntu 20.04 build