{"id":15197006,"url":"https://github.com/pem-humboldt/wiutils","last_synced_at":"2025-08-09T20:17:21.508Z","repository":{"id":37308864,"uuid":"344289206","full_name":"PEM-Humboldt/wiutils","owner":"PEM-Humboldt","description":"Exploration utilities for Wildlife Insights projects.","archived":false,"fork":false,"pushed_at":"2023-03-21T23:50:22.000Z","size":1773,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-02T21:13:16.378Z","etag":null,"topics":["biodiversity","camera-trap","images","matplotlib","numpy","pandas","python","seaborn","trail-cameras","wildlife-insights"],"latest_commit_sha":null,"homepage":"https://wiutils.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PEM-Humboldt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-03-03T23:11:03.000Z","updated_at":"2022-05-12T18:10:28.000Z","dependencies_parsed_at":"2023-09-24T12:10:24.951Z","dependency_job_id":null,"html_url":"https://github.com/PEM-Humboldt/wiutils","commit_stats":{"total_commits":295,"total_committers":4,"mean_commits":73.75,"dds":"0.11525423728813555","last_synced_commit":"b50b7fc88da3091f00437cbc38eccf14e877caba"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PEM-Humboldt%2Fwiutils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PEM-Humboldt%2Fwiutils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PEM-Humboldt%2Fwiutils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PEM-Humboldt%2Fwiutils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PEM-Humboldt","download_url":"https://codeload.github.com/PEM-Humboldt/wiutils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241570921,"owners_count":19984002,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biodiversity","camera-trap","images","matplotlib","numpy","pandas","python","seaborn","trail-cameras","wildlife-insights"],"created_at":"2024-09-28T00:23:00.201Z","updated_at":"2025-03-02T21:13:20.163Z","avatar_url":"https://github.com/PEM-Humboldt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wiutils\n\n![](https://img.shields.io/pypi/pyversions/wiutils)\n![](https://img.shields.io/pypi/v/wiutils?color=blue)\n![](https://img.shields.io/conda/vn/conda-forge/wiutils?color=blue)\n\n`wiutils` has several utilities for exploring and manipulating (filtering, plotting and summarizing) information from [Wildlife Insights](https://www.wildlifeinsights.org/) projects. These functions are useful to compute basic statistics, prepare the information for further analysis (*e.g.* occupancy models) and translate it into other standards (*i.e.* Darwin Core) that facilitate its publication on biodiversity information centers (*e.g.* GBIF).\n\n## Installation\nCurrently, `wiutils` works with Python versions 3.6 through 3.10.\n\nUsing `pip`:\n```shell\npip install wiutils\n```\n\nUsing `conda`:\n```shell\nconda install -c conda-forge wiutils\n```\n\n## Execution\nTo check whether the installation of `wiutils` was successful, execute the following command:\n\n```shell\npython -c \"import wiutils\"\n```\nIf this does not throw any error, the installation was successful.\n\nYou can use `wiutils` functions by importing the package from a Python console or script. For more information about the available functions, check the [documentation](https://wiutils.readthedocs.io).\n\n## How to contribute\nEverybody is welcome to contribute to `wiutils`. People can contribute to the development of the package but also to the improvement of the documentation and by [reporting potential bugs](https://github.com/PEM-Humboldt/wiutils/issues).\n\n## Setup\nIt is recommended to install the package using a [virtual environment](https://www.python.org/dev/peps/pep-0405/) to avoid tampering other Python installations in your system.\n\nClone this repo in your computer:\n```shell\ngit clone https://github.com/PEM-Humboldt/wiutils.git\n```\n\nGo to the project's root:\n```shell\ncd wiutils\n```\n\nInstall the package in development mode:\n```shell\npip install --editable .[dev,docs,test]\n```\n\nMake sure that any new development is done in a new branch. After you are finished, submit a [pull request](https://docs.github.com/en/pull-requests) to incorporate the changes.\n\n## Unit tests\nExecute the following command inside the project's root:\n```shell\npytest tests/\n```\n\n## Python versions\n`wiutils` works with Python versions 3.6 through 3.10. To make sure that the code works for all these versions, [`tox`](https://tox.wiki) is used. Make sure you have installed these Python versions on your system and then run the following command inside the project's root:\n```shell\ntox\n```\n\nThis will run all the unit tests for every Python version to make sure everything works correctly.\n\nIf you add any new depedency to the project, make sure to run tox as follows so it can recreate the environments:\n```shell\ntox -r\n```\n\n## Code coverage\nWe make sure the code coverage is 100%. Ideally, when implementing new features or making changes, you should make sure that the code coverage is still 100%. For this, run the coverage for the tests:\n```shell\ncoverage run -m pytest tests/\n```\n\nAnd then run the report:\n```shell\ncoverage report -m -i\n```\n\n## Code style\nWe use pre-commit hooks to make sure new changes adhere to different coding guidelines. You need to install these hooks just once (ideally before doing any commit) by running:\n```shell\npre-commit install\n```\n\nAfter that, every commit you try to make will run the hooks before committing the changes. If the hooks modified your changes, you'll have to add those files and commit again.\n\n## Authors and contributors\n* Adriana Restrepo-Isaza\n* Angélica Diaz-Pulido\n* Marcelo Villa-Piñeros - [marcelovilla](https://github.com/marcelovilla)\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpem-humboldt%2Fwiutils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpem-humboldt%2Fwiutils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpem-humboldt%2Fwiutils/lists"}