circlize

Overview

About

Maintained by Zuguang GuFirst published 2013-05-2650 releasesCRAN page ↗GitHub ↗

Circular layout is an efficient way for the visualization of huge amounts of information. Here this package provides an implementation of circular layout generation in R as well as an enhancement of available software. The flexibility of the package is based on the usage of low-level graphics functions such that self-defined high-level graphics can be easily implemented by users for specific purposes. Together with the seamless connection between the powerful computational and visual environment in R, it gives users more convenience and freedom to design figures for better understanding complex patterns behind multiple dimensional data. The package is described in Gu et al. 2014 doi:10.1093/bioinformatics/btu393.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("circlize", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("jokergoo/circlize")

Development version from jokergoo/circlize. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-circlize

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-circlize

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-circlize

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 3.9 min · r-devel-linux-x86_64-fedora-clang

Code health

None

Tests · ratio 0.00

not tracked

Coverage

100%

Documentation · exports

9

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMENoVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 89%
Documented parameters: 97%
Return-value docs: 17%
References docs: 0%

Downloads

653.8K

CRAN downloads in the past year

Rank #445 · ~1.8K/day · ~54.5K/mo

Releases R versions

Daily download trend is not available in this view yet.

60.3K30 days

193.4K90 days

653.8K1 year

Compare downloads with other packages →

Also on4.4K r2u41 autocran58K conda_forge331 bioconda604 c2d4u

Repository

GitHub ↗ jokergoo/circlize

1,019Stars

148Forks

66Open issues

1Open PRs

0Releases

909Commits

9Contributors

909 commits · Last activity 2023-11-11 · +0.1% stars, 30d

Stars over time

2025-07-22 · 9822026-07-07 · 1,019

Repository practices

Upstream repositoryBeta

3 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/jokergoo/circlize on 2026-07-19.

Continuous integration (1)

GitHub Actions

Coverage (1)

Codecov

Governance and community (1)

Issue templates

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

12 external dependencies (excludes base and recommended)

Depends (2)

R >= 4.0.0graphics

Imports (8)

GlobalOptions shapegrDevicesutilsstatscolorspacemethodsgrid

LinkingTo (0)

none

Suggests (9)

knitr dendextend ComplexHeatmap gridBase png markdown bezier covr rmarkdown

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

72direct

3indirect

and 24 more packages.

Code & Tests

Code Composition

R 13,021 (68%)Rd 5,991 (31%)Vignettes 11 (0%)

Code characteristics

Object systems

S33

Cyclomatic complexity: 3.0 median / 127 max

Test coverage

Line coverage

–

Expression

–

Tests / Examples

–

Functions

192 112 exported

Complexity

8.8 avg / 127 max

Call network

192 nodes / 608 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

Per-function coverage is not measured for this package yet.

People & History

People (1)

Maintainer (1)

Zuguang Gu

Author, Maintainer

Authors (1)

Zuguang Gu

Author, Maintainer

Package Timeline

50 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
0.4.18Latest
2026-04-04 · current release · diff ↗
0.4.17
2025-12-08 · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
0.4.16
2024-02-20 · diff ↗
R
R 4.3.0 released · 2023-04-21
0.4.15
2022-05-10 · diff ↗
R
R 4.2.0 released · 2022-04-22
0.4.14
2022-02-11 · diff ↗
0.4.13
2021-06-09 · diff ↗
R
R 4.1.0 released · 2021-05-18
0.4.12
2021-01-08 · diff ↗
0.4.11
2020-10-31 · diff ↗
0.4.10
2020-06-15 · diff ↗
0.4.9
2020-05-01 · diff ↗

Show 48 earlier events

R
R 4.0.0 released · 2020-04-24
0.4.8
2019-09-08 · diff ↗
0.4.7
2019-08-21 · diff ↗
R
R 3.6.0 released · 2019-04-26
0.4.6
2019-04-03 · diff ↗
0.4.5
2018-11-21 · diff ↗
0.4.4
2018-06-10 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.4.3
2017-12-20 · diff ↗
0.4.2
2017-11-18 · diff ↗
0.4.1
2017-07-19 · diff ↗
0.4.0
2017-05-29 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.3.10
2017-03-07 · diff ↗
0.3.9
2016-09-26 · diff ↗
0.3.8
2016-08-14 · diff ↗
0.3.7
2016-05-15 · diff ↗
R
R 3.3.0 released · 2016-05-03
0.3.6
2016-04-23 · diff ↗
0.3.5
2016-03-28 · diff ↗
0.3.4
2015-12-22 · diff ↗
0.3.3
2015-11-26 · diff ↗
0.3.2
2015-10-21 · diff ↗
0.3.1
2015-08-19 · diff ↗
0.3.0
2015-08-01 · diff ↗
0.2.5
2015-07-08 · diff ↗
R
R 3.2.0 released · 2015-04-16
0.2.4
2015-03-20 · diff ↗
0.2.3
2015-02-22 · diff ↗
0.2.2
2015-01-30 · diff ↗
0.2.1
2015-01-09 · diff ↗
0.2.0
2014-12-08 · diff ↗
0.1.3
2014-11-07 · diff ↗
0.1.2
2014-10-13 · diff ↗
0.1.1
2014-09-01 · diff ↗
0.1.0
2014-08-02 · diff ↗
0.0.9
2014-07-11 · diff ↗
0.0.8
2014-06-03 · diff ↗
R
R 3.1.0 released · 2014-04-10
3.0.3
2013-10-01 · diff ↗
0.0.7
2013-10-01 · diff ↗
0.0.6
2013-09-02 · diff ↗
3.0.2
2013-09-01 · diff ↗
0.0.5
2013-08-03 · diff ↗
0.0.4
2013-07-05 · diff ↗
0.0.3
2013-06-02 · diff ↗
0.0.2
2013-05-26
R
R 3.0.0 released · 2013-04-03

Package metadata

First published: 2013-05-26
Total releases: 50 / 13 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.0.0
Download size: 2.4 MB
Installed size: not tracked yet
With dependencies: not tracked yet