Installation

Circhart is a standalone desktop software designed to run on Windows, Linux and MacOS.

Circhart download: https://github.com/lmdu/circhart/releases

中国镜像下载地址: https://big.cdu.edu.cn/software/circhart

On Windows

Go to https://github.com/lmdu/circhart/releases page, click on Circhart-vx.x.x-win-x64.exe to download it. Then double click the downloaded installer to install the program following the on-screen instructions.

On Linux

  1. Go to https://github.com/lmdu/circhart/releases page, click on Circhart-vx.x.x-linux-x64.AppImage to download it. You can double click the .AppImage file to run it.

  2. Or, you can run it in terminal like this:

chmod +x Circhart-vx.x.x-linux-x64.AppImage
./Circhart-vx.x.x-linux-x64.AppImage

On MacOS

  1. Go to https://github.com/lmdu/circhart/releases page. For intel CPU, you should click on Circhart-vx.x.x-macos-x64.dmg to download it. For Apple M-series CPU, you should click on Circhart-vx.x.x-macos-arm64.dmg to download it

  2. Double click the downloaded dmg file, and then drag circhart to your application folder to install.

  3. When you run Circhart for the first time, you will see a prompt dialog, click the Done button.

  4. To allow Circhart to run on your Mac, go to System Settings > Privacy & Security.

  5. Scroll to Security section, you will see “Circhart” was blocked to protect you Mac. Click Open Anyway.

  6. Then, you will see a prompt dialog, click the Open Anyway button.

  7. Finally, you will be prompted to enter your password. The Circhart will be run successfully.

Circos dependencies

If you draw circos plots on Linux and MacOS, you must install missing perl modules needed by circos.

Note

On Windows, circos can run without any dependency, just ignore this step.

  1. Go to Tools menu, click Check Circos Dependencies to open a dialog, where you can see the missing perl modules.

  2. You can view the cpan documentation for finding How to install CPAN modules.

  3. First, install cpanm to make installing other modules easier. Open the Linux or MacOS terminal and type the command:

    cpan App::cpanminus

  4. Now you can install the missing modules using command cpanm, for example:

    cpanm Config::General

  5. When module successfully installed, you can click the Refresh button on dialog to view module status.

  6. When status of all Perl modules displays ok, you can run Circhart to draw circos plots.