Science Score: 59.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○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
8 of 121 committers (6.6%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (17.8%) to scientific vocabulary
Keywords
Keywords from Contributors
Repository
Python library for reading and writing image data
Basic Info
- Host: GitHub
- Owner: imageio
- License: bsd-2-clause
- Language: Python
- Default Branch: master
- Homepage: https://imageio.readthedocs.io
- Size: 3.58 MB
Statistics
- Stars: 1,624
- Watchers: 31
- Forks: 322
- Open Issues: 123
- Releases: 72
Topics
Metadata Files
README.md
IMAGEIO
Website: https://imageio.readthedocs.io/
Imageio is a mature Python library that makes it easy to read and write image and video data. This includes animated images, video, volumetric data, and scientific formats. It is cross-platform, runs on Python 3.9+, and is easy to install.
Professional support is available via Tidelift.
Example
Here's a minimal example of how to use imageio. See the docs for more examples.
python
import imageio.v3 as iio
im = iio.imread('imageio:chelsea.png') # read a standard image
im.shape # im is a NumPy array of shape (300, 451, 3)
iio.imwrite('chelsea.jpg', im) # convert to jpg
API in a nutshell
You just have to remember a handful of functions:
python
imread() # for reading
imwrite() # for writing
imiter() # for iterating image series (animations/videos/OME-TIFF/...)
improps() # for standardized metadata
immeta() # for format-specific metadata
imopen() # for advanced usage
See the API docs for more information.
Features
- Simple interface via a concise set of functions
- Easy to install using Conda or pip
- Few core dependencies (only NumPy and Pillow)
- Pure Python, runs on Python 3.9+, and PyPy
- Cross platform, runs on Windows, Linux, macOS
- More than 295 supported formats
- Read/Write support for various resources (files, URLs, bytes, FileLike objects, ...)
- High code quality and large test suite including functional, regression, and integration tests
Dependencies
Minimal requirements:
- Python 3.9+
- NumPy
- Pillow >= 8.3.2
Optional Python packages:
- imageio-ffmpeg (for working with video files)
- pyav (for working with video files)
- tifffile (for working with TIFF files)
- itk or SimpleITK (for ITK plugin)
- astropy (for FITS plugin)
- imageio-flif (for working with FLIF image files)
Security contact information
To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.
ImageIO for enterprise
Available as part of the Tidelift Subscription.
The maintainers of imageio and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. (Learn more)
Details
The core of ImageIO is a set of user-facing APIs combined with a plugin manager. API calls choose sensible defaults and then call the plugin manager, which deduces the correct plugin/backend to use for the given resource and file format. The plugin manager adds sensible backend-specific defaults and then calls one of ImageIOs many backends to perform the actual loading. This allows ImageIO to take care of most of the gory details of loading images for you, while still allowing you to customize the behavior when and where you need to. You can find a more detailed explanation of this process in our documentation.
Contributing
We welcome contributions of any kind. Here are some suggestions on how you are able to contribute
- add missing formats to the format list
- suggest/implement support for new backends
- report/fix any bugs you encounter while using ImageIO
To assist you in getting started with contributing code, take a look at the development section of the docs. You will find instructions on setting up the dev environment as well as examples on how to contribute code.
Owner
- Name: ImageIO
- Login: imageio
- Kind: organization
- Location: Sweden
- Website: http://imageio.github.io
- Repositories: 6
- Profile: https://github.com/imageio
Read and write images in any format.
GitHub Events
Total
- Create event: 4
- Release event: 2
- Issues event: 21
- Watch event: 144
- Delete event: 2
- Issue comment event: 43
- Push event: 10
- Pull request review comment event: 11
- Pull request review event: 15
- Pull request event: 28
- Fork event: 28
Last Year
- Create event: 4
- Release event: 2
- Issues event: 21
- Watch event: 144
- Delete event: 2
- Issue comment event: 43
- Push event: 10
- Pull request review comment event: 11
- Pull request review event: 15
- Pull request event: 28
- Fork event: 28
Committers
Last synced: 8 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Almar Klein | a****n@g****m | 655 |
| Sebastian Wallkötter | s****n@w****t | 268 |
| Steven Silvester | s****r@i****g | 79 |
| Anthony Tanbakuchi | a****i@g****m | 42 |
| github-actions | a****n@g****m | 38 |
| github-actions | g****s@g****m | 30 |
| paulmueller | p****r | 29 |
| Anthony Tanbakuchi | a****k@s****v | 27 |
| Juan Nunez-Iglesias | j****n@u****u | 18 |
| Mark Harfouche | m****e@g****m | 12 |
| lschr | l****l@t****t | 9 |
| Dennis van Gerwen | d****n@m****m | 8 |
| Pandede | s****9@g****m | 8 |
| Antony Lee | a****e@g****m | 7 |
| almar.klein | d****l@l****t | 7 |
| Matt McCormick | m****k@k****m | 6 |
| legendin | l****n@g****m | 5 |
| Steven A. Cholewiak | s****k@g****m | 5 |
| Arash Rai | a****7@g****m | 4 |
| Tim D. Smith | g****t@t****s | 4 |
| Hugo | h****k | 4 |
| Marcin Konowalczyk | m****k@s****k | 4 |
| Miloš Komarčević | 4****s | 3 |
| Joel Nises | j****l@n****e | 3 |
| Ghislain Antony Vaillant | g****l | 3 |
| Lukas Schrangl | s****l@i****t | 3 |
| Chris Dusold | G****b@c****m | 2 |
| Christoph Gohlke | c****e@g****m | 2 |
| DavidKorczynski | d****d@a****m | 2 |
| Felix Kohlgrüber | f****r@g****m | 2 |
| and 91 more... | ||
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 148
- Total pull requests: 114
- Average time to close issues: 3 months
- Average time to close pull requests: 24 days
- Total issue authors: 115
- Total pull request authors: 41
- Average comments per issue: 3.45
- Average comments per pull request: 1.6
- Merged pull requests: 89
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 19
- Pull requests: 31
- Average time to close issues: about 1 month
- Average time to close pull requests: 17 days
- Issue authors: 19
- Pull request authors: 14
- Average comments per issue: 0.89
- Average comments per pull request: 0.74
- Merged pull requests: 15
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- FirefoxMetzger (7)
- hmaarrfk (6)
- apiszcz (5)
- petsuter (4)
- anjos (3)
- olebole (3)
- djhoese (3)
- mgorny (3)
- hookxs (2)
- Wanglongzhi2001 (2)
- smidm (2)
- eigenvivek (2)
- BootsManOut (2)
- kloczek (2)
- ArtyomVancyan (1)
Pull Request Authors
- FirefoxMetzger (51)
- Pandede (22)
- lschr (6)
- almarklein (4)
- mgorny (3)
- michael080808 (2)
- tahseenadit (2)
- cwood1967 (2)
- kushalkolar (2)
- shaform (2)
- johnathanchiu (2)
- jasonkena (2)
- dcb-imvaria (2)
- boidolr (2)
- claydugo (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 7
-
Total downloads:
- pypi 29,398,579 last-month
- Total docker downloads: 1,160,410,339
-
Total dependent packages: 942
(may contain duplicates) -
Total dependent repositories: 27,512
(may contain duplicates) - Total versions: 268
- Total maintainers: 4
pypi.org: imageio
Library for reading and writing a wide range of image, video, scientific, and volumetric data formats.
- Homepage: https://github.com/imageio/imageio
- Documentation: https://imageio.readthedocs.io/
- License: BSD-2-Clause
-
Latest release: 2.37.0
published about 1 year ago
Rankings
Maintainers (2)
alpine-edge: py3-imageio
Python library that provides an easy interface to read and write a wide range of image data
- Homepage: https://github.com/imageio/imageio
- License: BSD-2-Clause
-
Latest release: 2.37.0-r0
published 7 months ago
Rankings
Maintainers (1)
spack.io: py-imageio
Python library for reading and writing image data. Imageio is a Python library that provides an easy interface to read and write a wide range of image data, including animated images, video, volumetric data, and scientific formats. It is cross-platform, runs on Python 2.7 and 3.4+, and is easy to install.
- Homepage: https://github.com/imageio/imageio
- License: []
-
Latest release: 2.35.1
published over 1 year ago
Rankings
Maintainers (1)
proxy.golang.org: github.com/imageio/imageio
- Documentation: https://pkg.go.dev/github.com/imageio/imageio#section-documentation
- License: bsd-2-clause
-
Latest release: v2.37.0+incompatible
published about 1 year ago
Rankings
conda-forge.org: imageio
- Homepage: https://imageio.github.io
- License: BSD-2-Clause
-
Latest release: 2.22.0
published over 3 years ago
Rankings
alpine-edge: py3-imageio-pyc
Precompiled Python bytecode for py3-imageio
- Homepage: https://github.com/imageio/imageio
- License: BSD-2-Clause
-
Latest release: 2.37.0-r0
published 7 months ago
Rankings
Maintainers (1)
anaconda.org: imageio
Imageio is a Python library that provides an easy interface to read and write a wide range of image data, including animated images, video, volumetric data, and scientific formats.
- Homepage: https://imageio.github.io
- License: BSD-2-Clause
-
Latest release: 2.37.0
published about 1 year ago
Rankings
Dependencies
- numpy *
- actions/checkout v3 composite
- actions/setup-python v4 composite
- relekang/python-semantic-release master composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- liskin/gh-problem-matcher-wrap v2 composite
- psf/black 22.8.0 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite