https://github.com/ropensci/ijtiff
An R Package for general purpose TIFF file I/O which plays nice with ImageJ
https://github.com/ropensci/ijtiff
image-manipulation imagej peer-reviewed r r-package rstats tiff-files tiff-images
Last synced: 3 months ago
JSON representation
An R Package for general purpose TIFF file I/O which plays nice with ImageJ
- Host: GitHub
- URL: https://github.com/ropensci/ijtiff
- Owner: ropensci
- Created: 2018-02-22T05:31:54.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-04-05T21:25:21.000Z (9 months ago)
- Last Synced: 2025-10-17T19:48:38.565Z (3 months ago)
- Topics: image-manipulation, imagej, peer-reviewed, r, r-package, rstats, tiff-files, tiff-images
- Language: R
- Homepage: https://docs.ropensci.org/ijtiff
- Size: 58.1 MB
- Stars: 17
- Watchers: 4
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- Codemeta: codemeta.json
Awesome Lists containing this project
README
---
output: github_document
---
```{r setup, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
original_files <- dir()
```
# ijtiff 
[](https://github.com/ropensci/ijtiff/actions)
[](https://app.codecov.io/gh/ropensci/ijtiff)
[](https://www.repostatus.org/#inactive)
[](https://cran.r-project.org/package=ijtiff)
[](https://doi.org/10.21105/joss.00633)
## Introduction
This is a general purpose TIFF I/O utility for R. The [`tiff` package](https://cran.r-project.org/package=tiff) already exists for this purpose but `ijtiff` adds some functionality and overcomes some bugs therein.
* `ijtiff` can write TIFF files whose pixel values are real (floating-point) numbers; `tiff` cannot.
* `ijtiff` can read and write _text images_; `tiff` cannot.
* `tiff` struggles to interpret channel information and gives cryptic errors when reading TIFF files written by the _ImageJ_ software; `ijtiff` works smoothly with these images.
To learn about `ijtiff` and how to use it, visit the package website at https://docs.ropensci.org/ijtiff/.
## Installation
### `libtiff`
`ijtiff` requires you to have the `libtiff` C library installed. To install `libtiff`:
* On __Debian Linux__, try `sudo apt-get install libtiff-dev libbz2-dev libdeflate-dev liblzma-dev libwebp-dev libzstd-dev zlib1g-dev`.
* On __Fedora Linux__, try `sudo yum install libtiff-devel libbz2-devel libdeflate-devel liblzma-devel libwebp-devel libzstd-devel zlib-devel`.
* On __Mac__, you need [Homebrew](https://brew.sh/). Then in the terminal, run `brew install libtiff`.
* On __Windows__, no setup is required.
### Installing the release version of the `ijtiff` R package
You can install `ijtiff` from CRAN (recommended) with:
```{r CRAN-installation, eval=FALSE}
install.packages("ijtiff")
```
### Installing the development version of the `ijtiff` R package
You can install the development version from GitHub with:
```{r GitHub-installation, eval=FALSE}
devtools::install_github("ropensci/ijtiff")
```
## Acknowledgement
This package uses a lot of code from the original `tiff` package by Simon Urbanek.
## Contribution
Contributions to this package are welcome. The preferred method of contribution is through a github pull request. Feel free to contact me by creating an issue. Please note that this project is released with a [Contributor Code of Conduct](https://github.com/ropensci/ijtiff/blob/master/CONDUCT.md). By participating in this project you agree to abide by its terms.
```{r cleanup, include = FALSE}
new_files <- setdiff(dir(), original_files)
file.remove(new_files)
```
[](https://ropensci.org)