hictkr

R bindings for hictk: read .cool and .hic files directly from R

https://github.com/paulsengroup/hictkr

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 7 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.4%) to scientific vocabulary

Keywords

3d-genomics bindings bioinformatics cooler genomics hi-c hic hictk r
Last synced: 4 months ago · JSON representation ·

Repository

R bindings for hictk: read .cool and .hic files directly from R

Basic Info
Statistics
  • Stars: 4
  • Watchers: 2
  • Forks: 0
  • Open Issues: 2
  • Releases: 3
Topics
3d-genomics bindings bioinformatics cooler genomics hi-c hic hictk r
Created over 2 years ago · Last pushed 4 months ago
Metadata Files
Readme License Citation

README.md

hictkR

License CI


R bindings for hictk, a blazing fast toolkit to work with .hic and .cool files.

Installing hictkR

hictkR can be installed directly from GitHub.

Installing hictkR requires a compiler toolchain supporting C++17, such as:

  • GCC 8+
  • Clang 8+
  • Apple-Clang 10.0+

On Windows a suitable compiler toolchain can be installed using Rtools.

To install hictkR run the following command inside an R prompt:

r install.packages("devtools") devtools::install_github("paulsengroup/hictkR@v0.0.3")

Using hictkR

```r library(hictkR)

path <- "file.mcool" # "file.hic" f <- File(path, resolution=100000)

df <- fetch(f, "chr1:0-10,000,000", "chr2:0-20,000,000", join=TRUE) df ```

| chrom1 | start1 | end1 | chrom2 | start2 | end2 | count | | ------ | ------ | ------ | ------ | ------ | ------ | ----- | | chr1 | 0 | 100000 | chr2 | 0 | 100000 | 15 | | chr1 | 0 | 100000 | chr2 | 100000 | 200000 | 5 | | chr1 | 0 | 100000 | chr2 | 300000 | 400000 | 17 | | chr1 | 0 | 100000 | chr2 | 400000 | 500000 | 22 | | chr1 | 0 | 100000 | chr2 | 500000 | 600000 | 30 | | chr1 | 0 | 100000 | chr2 | 600000 | 700000 | 21 | | chr1 | 0 | 100000 | chr2 | 600000 | 700000 | 21 | | ... | ... | ... | ... | ... | ... | ... |

Refer to the manual and vignette available at paulsengroup.github.io/hictkR for more examples on how to use hictkR.

Citing

If you use hictkR in you reaserch, please cite the following publication:

Roberto Rossini, Jonas Paulsen, hictk: blazing fast toolkit to work with .hic and .cool files Bioinformatics, Volume 40, Issue 7, July 2024, btae408, https://doi.org/10.1093/bioinformatics/btae408

BibTex ```bibtex @article{hictk, author = {Rossini, Roberto and Paulsen, Jonas}, title = "{hictk: blazing fast toolkit to work with .hic and .cool files}", journal = {Bioinformatics}, volume = {40}, number = {7}, pages = {btae408}, year = {2024}, month = {06}, issn = {1367-4811}, doi = {10.1093/bioinformatics/btae408}, url = {https://doi.org/10.1093/bioinformatics/btae408}, eprint = {https://academic.oup.com/bioinformatics/article-pdf/40/7/btae408/58385157/btae408.pdf}, } ```

Owner

  • Name: paulsengroup
  • Login: paulsengroup
  • Kind: organization

Citation (CITATION.cff)

# Copyright (C) 2025 Roberto Rossini <roberros@uio.no>
#
# SPDX-License-Identifier: GPL-2.0-or-later
#
# This library is free software: you can redistribute it and/or
# modify it under the terms of the GNU Public License as published
# by the Free Software Foundation; either version 3 of the License,
# or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Library General Public License for more details.
#
# You should have received a copy of the GNU Public License along
# with this library.  If not, see
# <https://www.gnu.org/licenses/>.


cff-version: 1.2.0
message: 'If you use this software, please cite it using the metadata from this file.'
authors:
  - given-names: Roberto
    family-names: Rossini
    orcid: 'https://orcid.org/0000-0003-3096-1470'
    email: roberros@uio.no
    affiliation: 'Department of Biosciences, University of Oslo'
title: hictkR
abstract: 'R bindings for hictk.'
# doi: 'TODO'
url: 'https://github.com/paulsengroup/hictkR'
repository-code: 'https://github.com/paulsengroup/hictkR'
type: software
license: GPL-2.0-or-later
preferred-citation:
  type: article
  authors:
  - given-names: Roberto
    family-names: Rossini
    orcid: 'https://orcid.org/0000-0003-3096-1470'
    email: roberros@uio.no
    affiliation: 'Department of Biosciences, University of Oslo'
  - given-names: Jonas
    family-names: Paulsen
    orcid: 'https://orcid.org/0000-0002-7918-5495'
    email: jonas.paulsen@ibv.uio.no
    affiliation: 'Department of Biosciences, University of Oslo'
  doi: '10.1101/2023.11.26.568707'
  url: 'https://doi.org/10.1101/2023.11.26.568707'
  journal: 'Cold Spring Harbor Laboratory'
  year: 2023
  month: 11
  title: 'hictk: blazing fast toolkit to work with .hic and .cool files'
  abstract: 'We developed hictk, a toolkit that can transparently operate on .hic and .cool files with excellent performance. The toolkit is written in C++ and consists of a C++ library with Python bindings as well as CLI tools to perform common operations directly from the shell, including converting between .hic and .mcool formats. We benchmark the performance of hictk and compare it with other popular tools and libraries. We conclude that hictk significantly outperforms existing tools while providing the flexibility of natively working with both file formats without code duplication.'

GitHub Events

Total
  • Delete event: 8
  • Issue comment event: 3
  • Push event: 88
  • Pull request event: 19
  • Create event: 8
Last Year
  • Delete event: 8
  • Issue comment event: 3
  • Push event: 88
  • Pull request event: 19
  • Create event: 8

Dependencies

.github/workflows/ci.yml actions
  • actions/cache/restore v3 composite
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • r-lib/actions/check-r-package v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
DESCRIPTION cran
  • Rcpp * imports
  • methods * imports
  • testthat >= 3.0.0 suggests