Add license
[loomr.git] / README.md
1 <!--
2 [![CRAN Version](https://www.r-pkg.org/badges/version/loomR)](https://cran.r-project.org/package=loomR)
3 [![CRAN Downloads](https://cranlogs.r-pkg.org/badges/loomR)](https://cran.r-project.org/package=loomR)
4 -->
5
6 # loomR
7
8 ### An R interface for loom files
9
10 For more information on loom files, please see the documentation for [loompy](https://github.com/linnarsson-lab/loompy)
11
12 ## Tutorial
13
14 A tutorial for loomR can be found [here](http://satijalab.org/loomR/loomR_tutorial.html). A full function and method reference can be found [here](http://satijalab.org/loomR/loomR.pdf).
15
16 ## Compatability with loompy
17
18 loomR aims to be completely compatible with loompy. Currently, loomR implements the following methods of the loompy API:
19  - map/apply
20  - create
21  - connect
22  - combine
23  - subset
24  - add layer
25  - add attriute
26  - add graph
27  - add cells
28  - add loom
29
30 ## Dependencies
31
32 loomR depends on:
33  - [R](https://cran.r-project.org/) v3.4.x
34  - The [R6](https://cran.r-project.org/package=R6) package
35  - The [hdf5r](https://cran.r-project.org/package=hdf5r) package
36  - The [iterators](https://cran.r-project.org/package=iterators) package
37  - The [itertools](https://cran.r-project.org/package=itertools) package
38  - The HDF5 [C++ API](https://support.hdfgroup.org/HDF5/release/obtainsrc.html)
39
40 To get the HDF5 C++ API, please see the table below:
41
42 | Operating system | Command |
43 | ---------------- | ------- |
44 | macOS | Using [Homebrew](https://brew.sh/), `brew install hdf5` |
45 | Debian and Debian-based OSes | `sudo apt install libhdf5-dev` |
46 | Red Hat-based OSes | `sudo dnf install hdf5-devel` or `sudo yum install hdf5-devel` |
47 | Windows | Download precombiled binaries from Mario Annau [here](https://github.com/mannau/h5-libwin) |