Python interface to the R language (embedded R)
Project description
Python -> R bridge
The project's webpage is here: https://rpy2.github.io/
Installation
Released versions can be installed from a package repository (default being pypi) using pip:
pip install rpy2
The package has optional depencies providing specific functionalities not otherwise required to use the rest of rpy2.
For example, to be able to run the unit tests:
pip install 'rpy2[test]'
To install all optional dependencies (numpy, pandas, ipython), use:
pip install 'rpy2[all]'
Installation for rpy2 developers
If a developer, the package can be installed from its source tree.
rpy2 is a namespace package with its consituting parts in different
"sub-packages".
To install from the source tree, just enter:
pip install ./rpy2-rinterface/ ./rpy2-robjects/ .
Various optional dependencies can be specified through dependency groups. For example:
pip install ./rpy2-rinterface'[all]' ./rpy2-robjects'[all]' '.[all]'
rpy2-rinterface contains the binding to R's C API. Building from
source require a compilation toolchain / developper tools installed,
and you will have to figure out how to have them installed on your
system by yourself. The CI pipeline builds binary wheels for Linux,
MacOS, and Windows. Watching how things are set up there is pretty
much all documentation from the package maintainers on the matter.
Issues loading shared C libraries
Whenever R is in not installed in a system location, the system might not know where to find the R shared library.
If R is in the PATH, that is entering R on the command line successfully starts
an R terminal, but rpy2 does not work because of missing C libraries, try the following
before starting Python:
export LD_LIBRARY_PATH="$(python -m rpy2.situation LD_LIBRARY_PATH)":${LD_LIBRARY_PATH}
Documentation
Documentation is available either in the source tree (doc/),
or online.
Testing
rpy2 uses pytest, with the plugin pytest-cov for code coverage. To
test the package from the source tree, either to check and installation
on your system or before submitting a pull request, do:
pytest rpy2-rinterface/ rpy2-robjects/
For code coverage, do:
pytest --cov=rpy2.rinterface_lib \
--cov=rpy2.rinterface \
--cov=rpy2.ipython \
--cov=rpy2.robject \
rpy2-rinterface/ rpy2-robjects/
For more options, such as how to run specify tests, please refer to the pytest
documentation.
License
RPy2 can be used under the terms of the GNU General Public License Version 2 or later (see the file gpl-2.0.txt). This is the very same license R itself is released under.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rpy2-3.6.4.tar.gz.
File metadata
- Download URL: rpy2-3.6.4.tar.gz
- Upload date:
- Size: 53.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a24e8dda5c5ff8cbd2b8ebd1ccf6f1a5a0a576623700cf91e2cce98d41a79fd3
|
|
| MD5 |
73a1368bc6b1e8eaef5b588daf7e02fc
|
|
| BLAKE2b-256 |
dfba393d5aaf21204d7678e59f7e7cd54d9a929d5f7ad8218f172100c8c7a6c8
|
File details
Details for the file rpy2-3.6.4-py3-none-any.whl.
File metadata
- Download URL: rpy2-3.6.4-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
edf437d6637b89311f860fb3e44144ea5eff286a65c48645805833baff090621
|
|
| MD5 |
c0c98f2c04b1c248faa551ec85c12b6b
|
|
| BLAKE2b-256 |
0993d49eccd6662ff5cec439f9de716e6520c990cec031fcdd8d08e7fd530681
|
