- What is transferase
- What's new
- Current status
- Installation
- Command line app
- The Python package
- The R package
- All documentation
Transferase is a system for retrieving DNA methylation levels through user-defined sets of genomic intervals. When analyzing whole-genome DNA methylation profiles ("methylomes"), this form of summary statistic is central to both hypothesis testing and exploratory data analysis. In particular, it is the basis of identifying differentially methylated regions, clustering methylomes based on subsets of genes and other genomic features, and clustering genomic features according to their methylation dynamics.
The motivation behind transferase is simple. Methylomes derived from whole-genome sequencing are huge. Even with access to high-performance computing, downloading, moving and processing a collection of methylomes takes time. Any study leveraging this type of data will examine multiple different sets of genomic features and explore a variety of contrasts between methylomes. This process can and should be faster and more convenient. But attaining these goals requires methods that synergize to exploit certain unique characteristics of sequencing-based whole-genome DNA methylation profiles.
Transferase is a complete system: it includes server software, a collection of file formats and algorithms, client apps and APIs, all co-designed to maximize efficiency of data retrieval. Transferase can run on a local system for an individual user, or remotely granting more users access to larger volumes of data. With a good network connection, queries to a remote transferase server can be faster than similar analysis of locally stored files.
A public transferase server currently provides access to MethBase2, a methylome database with roughly 13,800 vertebrate methylomes (as of 2025-05-27) that are whole-genome, sequencing-based and high-quality. Most of these are split between human and mouse. The transferase clients include tools to help identify which among those methylomes might be useful to inform specific biological questions.
-
If you work on Mac or Linux, there are lots of ways to get and use transferase.
-
Transferase is in early development and is improving quickly.
-
But this means frequent changes -- check back for updates, and star or watch this repo.
-
I appreciate your feedback. You can open an issue on GitHub or contact me (Andrew) directly via the email in my GitHub profile.
-
The options for query output formats and customization have been significantly improved in v0.6.2.
-
The
selectcommand now allows users to make methylome groups as they select them methylomes they want to query. -
The
selectcommand in the transferase command line app now includes more details about available methylomes (hit 'd' to turn on details). -
The transferase Python package, pyxfr, can now be installed using pip with Python >= 3.12 on Linux and macOS:
pip install pyxfr -
The Python and R packages each include a function that loads a data frame with extra information about the methylomes available through the public transferase server.
-
Public server: It's open and currently serving a lot of high-quality methylomes. Right now (2025-05-10) the only restriction on use is that individual queries are limited to roughly 45 methylomes, and roughly 1M query intervals. If you need more, just do multiple queries.
-
Linux: The binary installation for Linux should work on any Linux machine going back 15 years.
-
macOS: The binary installation for macOS should work on any Mac hardware that is running at least Ventura (macos-13; October 2022).
-
Python: The python package, pyxfr, can be installed with
pip install pyxfrand requires Python >= 3.12 but otherwise should work on any Linux and macOS-13 or later. -
R: The R package, Rxfr, can be installed on Linux and macOS, but it needs R version >= 4.4 and is not yet easy to install. Popular Linux distributions, and macOS 15, now include the right compilers. When the maintainers of R update some of their configurations, installing Rxfr will become simpler.
-
Linux The Linux binary releases should work on any Linux system. You can find installers here, including packages deb and rpm-based systems. The easiest is the shell installer:
sh transferase-0.6.2-Linux.sh --prefix=/desired/install/location /desired/install/location/bin/xfr # check that it worked
-
Mac The transferase binary for Mac is a "universal binary" and should work on any Mac. It is built to work on Ventura or later, but it has worked on a much older system. The easiest is the shell installer:
sh transferase-0.6.2-macOS.sh --prefix=/desired/install/location /desired/install/location/bin/xfr # check that it worked
-
Python pyxfr can be installed using pip with Python (>= 3.12) on Linux and macOS:
pip install pyxfr python3 -c "from pyxfr import pyxfr; help(pyxfr)" # check that it worked
-
R Detailed instructions to install Rxfr are in docs/installing_Rxfr.md.
-
Source Detailed instructions for building from source are in docs/building.md.
-
Linux packages
# Red Hat or Fedora (not sure SUSE has dnf) rpm -i transferase-0.6.2-Linux.rpm # See what will be installed sudo dnf install ./transferase-0.6.2-Linux.rpm # Install (note the dot-slash) dnf info transferase # See what was installed sudo dnf remove transferase # Uninstall # Ubuntu or Debian dpkg --info transferase-0.6.2-Linux.deb # See what will be installed sudo apt install ./transferase-0.6.2-Linux.deb # Install (note the dot-slash) apt info transferase # See what was installed sudo apt remove transferase # Uninstall