hictkr
R bindings for hictk: read .cool and .hic files directly from R
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
Repository
R bindings for hictk: read .cool and .hic files directly from R
Basic Info
- Host: GitHub
- Owner: paulsengroup
- License: other
- Language: C++
- Default Branch: main
- Homepage: https://paulsengroup.github.io/hictkR
- Size: 12.2 MB
Statistics
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 2
- Releases: 3
Topics
Metadata Files
README.md
hictkR
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
- Repositories: 3
- Profile: https://github.com/paulsengroup
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
- 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
- Rcpp * imports
- methods * imports
- testthat >= 3.0.0 suggests