6 . what is this?

The Circos table viewer uses the Circos application to turn data tables into chord diagrams.

into circularly composited visualizations like this

Through the settings panel You can control the manner in which your tabular data is parsed, filtered and displayed.

If you are interested in this approach, read Visualizing Tabular Data - Introduction. If you are interested in the details proceed to Visualizing Tabular Data - How to Use Circos to Visualize Tables.

This kind of plot is implemented in Pentaho and d3.js, which calls them chord diagrams. Circos table visualizations have been used to explore global migration (step-by-step tutorial) and inspired mosaic art.

7 . panel

Many people have used Circos to generate visual representations of tables. Below is a panel of 15,129 visualized tables. Download very hires hires.

A panel of Circos images showing data uploaded by users.

0 . read slogan badges

1 . check data format

Before uploading a data file, check the samples gallery to make sure that your data format is compatible.

  • File must be plain text.
  • Data values must be non-negative integers. If all are <1, multiply them by a fixed factor.
  • Data must be space-separated (one or more tab or space, which will be collapsed).
  • No two rows or columns may have the same name.
  • Column and row names must begin with a letter (e.g. 'A', 'A0', 'A-0') and can only contain letters, numbers and _. No punctuation! No double underscores.
  • Maximum number of rows × columns is 50 × 50.
  • If you are using order, size and color rows/columns in combination they must appear in that order.

If you do not adhere to these rules, expect errors.

Need help? Post questions to the Circos Google Group.

2a . upload your file

If you are using the size, order or color options below, make sure your input file has the appropriate content (see samples 5-9).

order
size
color

If you'd like to edit the image (e.g. arrange labels, change specific colors, etc) use the SVG file, which is provided in the download link once the image is created.

2b . try random data

Don't have a data file? No problem, try our random data generator. Adjust the settings to change the figure.

Circos Circos Circos Circos
Circos Circos Circos Circos

3 . wait 10-30 seconds

Some images can take a while to make &mdsah; be patient.

Current load is 0/2. System is available.

4 . privacy

Do not use this tool on confidential or sensitive information (use the offline tableviewer which has a tutorial). All any files you send or are created during the analysis will be deleted 10 minutes after your upload.

5 . updates

27.sep.22 You can now request an access code to visualize larger tables.

16.aug.22 Updated Max row/col logic. Updated logging. Minor cosmetic changes.

9.oct.15 Updated to use Circos 0.68. Added ability to hide first tick and force drawing last tick, which corresponds to segment size.

7.sep.12 Updated to use Circos 0.63. Batch file in batch/ now uses relative paths.

12.mar.12 Updated sample images.

7.mar.12 Fixed cookie bugs. Added image features: segment radius/spacing and segment/tick label color.

14.feb.12 Fixed bugs caused by Mac and DOS line ends.

8.feb.12 Fixed bugs caused by stale cookies.

3.jan.12 More image settings.

6.aug.10 Added colored ribbon caps to indicate identity of distant segment.

28.apr.10 Added quartile ribbon transparency and color options.

27.apr.10 Added ratio layout and verbose option reports.

23.apr.10 Archive added. Site layout updated.

22.apr.10 You can specify row/col color. See Sample 9.

25.mar.10 Ribbons now have transparency. Images are anti-aliased. Web tool now doesn't crash as often.


Found cookie. Not resetting.
Cookie version [0.63-10].
Updating cookie with any CGI parameters.
connection local

params

$VAR1 = {};

cookie

$VAR1 = { 'access_code' => [ '' ], 'color_ribbons_by_value' => [ '0' ], 'contribution_tracks' => [ '', '', '' ], 'encoding' => [ '' ], 'fade_transparency' => [ '0' ], 'format' => [ '', '', '', '', '', '', '', '' ], 'intra_segment' => [ '' ], 'label_segment_color' => [ 'vvvdgrey' ], 'label_segment_font' => [ 'normal' ], 'label_segment_font_size' => [ '24' ], 'label_segment_on_segment' => [ '' ], 'label_segment_parallel' => [ '1' ], 'label_tick_color' => [ 'vvvdgrey' ], 'label_tick_font' => [ 'light' ], 'label_tick_font_size' => [ '16' ], 'label_tick_parallel' => [ '0' ], 'min_percentile' => [ '0' ], 'normalize' => [ '0' ], 'placement_order' => [ 'row,col' ], 'q1ribbonc' => [ 'inherit' ], 'q1ribbons' => [ '1' ], 'q1ribbont' => [ 'inherit' ], 'q1ribbonuse' => [ '' ], 'q2ribbonc' => [ 'inherit' ], 'q2ribbons' => [ '1' ], 'q2ribbont' => [ 'inherit' ], 'q2ribbonuse' => [ '' ], 'q3ribbonc' => [ 'inherit' ], 'q3ribbons' => [ '1' ], 'q3ribbont' => [ 'inherit' ], 'q3ribbonuse' => [ '' ], 'q4ribbonc' => [ 'inherit' ], 'q4ribbons' => [ '1' ], 'q4ribbont' => [ 'inherit' ], 'q4ribbonuse' => [ '' ], 'ratio_layout' => [ '' ], 'reverse_ribbons' => [ '' ], 'ribbon_bundle_order' => [ 'native' ], 'ribbon_caps' => [ '', '', '' ], 'ribbon_color_source' => [ 'row' ], 'ribbon_layer_order' => [ 'size_asc' ], 'segment_color_interpolation' => [ 'count' ], 'segment_color_order' => [ 'ascii' ], 'segment_order' => [ 'ascii' ], 'segment_order_progression' => [ 'size_desc' ], 'segment_radius' => [ '0.75' ], 'segment_spacing' => [ '0.0075r' ], 'segment_thickness' => [ '35p' ], 'transparency' => [ '1' ], 'version' => [ '0.63-10' ] };
CGI Param
ENV
CONTEXT_DOCUMENT_ROOT /home/martink/www/htdocs
CONTEXT_PREFIX
DOCUMENT_ROOT /home/martink/www/htdocs
GATEWAY_INTERFACE CGI/1.1
HTTPS on
HTTP_ACCEPT */*
HTTP_ACCEPT_ENCODING gzip, br, zstd, deflate
HTTP_CACHE_CONTROL max-age=259200
HTTP_CONNECTION keep-alive
HTTP_COOKIE tableviewer=BAsIMTIzNDU2NzgECAgIAzIAAAAEAgEAAAAKB2luaGVyaXQJAAAAcTJyaWJib25jBAIBAAAACgdp%0Abmhlcml0CQAAAHE0cmliYm9udAQCAQAAAAoHaW5oZXJpdAkAAABxM3JpYmJvbmMEAgEAAAAKAjI0%0AFwAAAGxhYmVsX3NlZ21lbnRfZm9udF9zaXplBAIBAAAACgMzNXARAAAAc2VnbWVudF90aGlja25l%0Ac3MEAgEAAAAKAAwAAAByYXRpb19sYXlvdXQEAgEAAAAKATEJAAAAcTNyaWJib25zBAIBAAAACgEx%0ACQAAAHEycmliYm9ucwQCAQAAAAoIc2l6ZV9hc2MSAAAAcmliYm9uX2xheWVyX29yZGVyBAIBAAAA%0ACgEwFgAAAGNvbG9yX3JpYmJvbnNfYnlfdmFsdWUEAgEAAAAKBWNvdW50GwAAAHNlZ21lbnRfY29s%0Ab3JfaW50ZXJwb2xhdGlvbgQCAwAAAAoACgAKABMAAABjb250cmlidXRpb25fdHJhY2tzBAIBAAAA%0ACgh2dnZkZ3JleRAAAABsYWJlbF90aWNrX2NvbG9yBAIBAAAACgAIAAAAZW5jb2RpbmcEAgEAAAAK%0AAAsAAABxNHJpYmJvbnVzZQQCAQAAAAoBMQkAAABxMXJpYmJvbnMEAgEAAAAKBm5vcm1hbBIAAABs%0AYWJlbF9zZWdtZW50X2ZvbnQEAgEAAAAKATAOAAAAbWluX3BlcmNlbnRpbGUEAgEAAAAKAA8AAABy%0AZXZlcnNlX3JpYmJvbnMEAgEAAAAKATAJAAAAbm9ybWFsaXplBAIBAAAACgVhc2NpaQ0AAABzZWdt%0AZW50X29yZGVyBAIBAAAACgIxNhQAAABsYWJlbF90aWNrX2ZvbnRfc2l6ZQQCAQAAAAoDcm93EwAA%0AAHJpYmJvbl9jb2xvcl9zb3VyY2UEAgEAAAAKBzAuNjMtMTAHAAAAdmVyc2lvbgQCAQAAAAoHaW5o%0AZXJpdAkAAABxMXJpYmJvbmMEAgMAAAAKAAoACgALAAAAcmliYm9uX2NhcHMEAgEAAAAKAAsAAABh%0AY2Nlc3NfY29kZQQCAQAAAAoJc2l6ZV9kZXNjGQAAAHNlZ21lbnRfb3JkZXJfcHJvZ3Jlc3Npb24E%0AAgEAAAAKAAsAAABxMXJpYmJvbnVzZQQCAQAAAAoBMQkAAABxNHJpYmJvbnMEAgEAAAAKATARAAAA%0AZmFkZV90cmFuc3BhcmVuY3kEAgEAAAAKBWxpZ2h0DwAAAGxhYmVsX3RpY2tfZm9udAQCAQAAAAoG%0AbmF0aXZlEwAAAHJpYmJvbl9idW5kbGVfb3JkZXIEAgEAAAAKB2luaGVyaXQJAAAAcTNyaWJib250%0ABAIBAAAACgh2dnZkZ3JleRMAAABsYWJlbF9zZWdtZW50X2NvbG9yBAIIAAAACgAKAAoACgAKAAoA%0ACgAKAAYAAABmb3JtYXQEAgEAAAAKB2luaGVyaXQJAAAAcTRyaWJib25jBAIBAAAACgExDAAAAHRy%0AYW5zcGFyZW5jeQQCAQAAAAoHMC4wMDc1cg8AAABzZWdtZW50X3NwYWNpbmcEAgEAAAAKB2luaGVy%0AaXQJAAAAcTJyaWJib250BAIBAAAACgdpbmhlcml0CQAAAHExcmliYm9udAQCAQAAAAoAGAAAAGxh%0AYmVsX3NlZ21lbnRfb25fc2VnbWVudAQCAQAAAAoEMC43NQ4AAABzZWdtZW50X3JhZGl1cwQCAQAA%0AAAoBMRYAAABsYWJlbF9zZWdtZW50X3BhcmFsbGVsBAIBAAAACgALAAAAcTNyaWJib251c2UEAgEA%0AAAAKB3Jvdyxjb2wPAAAAcGxhY2VtZW50X29yZGVyBAIBAAAACgEwEwAAAGxhYmVsX3RpY2tfcGFy%0AYWxsZWwEAgEAAAAKBWFzY2lpEwAAAHNlZ21lbnRfY29sb3Jfb3JkZXIEAgEAAAAKAA0AAABpbnRy%0AYV9zZWdtZW50BAIBAAAACgALAAAAcTJyaWJib251c2U%3D%0A
HTTP_HOST mk.bcgsc.ca
HTTP_REFERER https://mk.bcgsc.ca/tableviewer/tmp/iimxcrqsamp/circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org
HTTP_SURROGATE_CAPABILITY proxy11.dmz.bcgsc.ca="Surrogate/1.0 ESI/1.0"
HTTP_USER_AGENT Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
HTTP_VIA 1.1 proxy11.dmz.bcgsc.ca (squid/5.5)
MOD_PERL mod_perl/2.0.12
MOD_PERL_API_VERSION 2
PATH /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
PATH_INFO /circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org/
PATH_TRANSLATED /home/martink/www/htdocs/circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org/
QUERY_STRING
REMOTE_ADDR 216.73.216.151
REMOTE_PORT 47136
REQUEST_METHOD GET
REQUEST_SCHEME https
REQUEST_URI /tableviewer/tmp/iimxcrqsamp/circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org/
SCRIPT_FILENAME /home/martink/www/htdocs/tableviewer/tmp/iimxcrqsamp
SCRIPT_NAME /tableviewer/tmp/iimxcrqsamp
SCRIPT_URI https://mk.bcgsc.ca/tableviewer/tmp/iimxcrqsamp/circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org/
SCRIPT_URL /tableviewer/tmp/iimxcrqsamp/circos-tableviewer-iimxcrqsamp.tar.gz/d3js.org/
SERVER_ADDR 10.9.208.135
SERVER_ADMIN martink@bcgsc.ca
SERVER_NAME mk.bcgsc.ca
SERVER_PORT 443
SERVER_PROTOCOL HTTP/1.1
SERVER_SIGNATURE
SERVER_SOFTWARE Apache
UNIQUE_ID aG0S6nQoZfH7TUwHdWpvVwAAAAs

cookie

$VAR1 = bless( {
  'tableviewer' => bless( do{\(my $o = '139936678558928')}, 'Apache2::Cookie' )
}, 'APR::Request::Cookie::Table' );

$VAR1 = 'BAsIMTIzNDU2NzgECAgIAzIAAAAEAgEAAAAKB2luaGVyaXQJAAAAcTJyaWJib25jBAIBAAAACgdp
bmhlcml0CQAAAHE0cmliYm9udAQCAQAAAAoHaW5oZXJpdAkAAABxM3JpYmJvbmMEAgEAAAAKAjI0
FwAAAGxhYmVsX3NlZ21lbnRfZm9udF9zaXplBAIBAAAACgMzNXARAAAAc2VnbWVudF90aGlja25l
c3MEAgEAAAAKAAwAAAByYXRpb19sYXlvdXQEAgEAAAAKATEJAAAAcTNyaWJib25zBAIBAAAACgEx
CQAAAHEycmliYm9ucwQCAQAAAAoIc2l6ZV9hc2MSAAAAcmliYm9uX2xheWVyX29yZGVyBAIBAAAA
CgEwFgAAAGNvbG9yX3JpYmJvbnNfYnlfdmFsdWUEAgEAAAAKBWNvdW50GwAAAHNlZ21lbnRfY29s
b3JfaW50ZXJwb2xhdGlvbgQCAwAAAAoACgAKABMAAABjb250cmlidXRpb25fdHJhY2tzBAIBAAAA
Cgh2dnZkZ3JleRAAAABsYWJlbF90aWNrX2NvbG9yBAIBAAAACgAIAAAAZW5jb2RpbmcEAgEAAAAK
AAsAAABxNHJpYmJvbnVzZQQCAQAAAAoBMQkAAABxMXJpYmJvbnMEAgEAAAAKBm5vcm1hbBIAAABs
YWJlbF9zZWdtZW50X2ZvbnQEAgEAAAAKATAOAAAAbWluX3BlcmNlbnRpbGUEAgEAAAAKAA8AAABy
ZXZlcnNlX3JpYmJvbnMEAgEAAAAKATAJAAAAbm9ybWFsaXplBAIBAAAACgVhc2NpaQ0AAABzZWdt
ZW50X29yZGVyBAIBAAAACgIxNhQAAABsYWJlbF90aWNrX2ZvbnRfc2l6ZQQCAQAAAAoDcm93EwAA
AHJpYmJvbl9jb2xvcl9zb3VyY2UEAgEAAAAKBzAuNjMtMTAHAAAAdmVyc2lvbgQCAQAAAAoHaW5o
ZXJpdAkAAABxMXJpYmJvbmMEAgMAAAAKAAoACgALAAAAcmliYm9uX2NhcHMEAgEAAAAKAAsAAABh
Y2Nlc3NfY29kZQQCAQAAAAoJc2l6ZV9kZXNjGQAAAHNlZ21lbnRfb3JkZXJfcHJvZ3Jlc3Npb24E
AgEAAAAKAAsAAABxMXJpYmJvbnVzZQQCAQAAAAoBMQkAAABxNHJpYmJvbnMEAgEAAAAKATARAAAA
ZmFkZV90cmFuc3BhcmVuY3kEAgEAAAAKBWxpZ2h0DwAAAGxhYmVsX3RpY2tfZm9udAQCAQAAAAoG
bmF0aXZlEwAAAHJpYmJvbl9idW5kbGVfb3JkZXIEAgEAAAAKB2luaGVyaXQJAAAAcTNyaWJib250
BAIBAAAACgh2dnZkZ3JleRMAAABsYWJlbF9zZWdtZW50X2NvbG9yBAIIAAAACgAKAAoACgAKAAoA
CgAKAAYAAABmb3JtYXQEAgEAAAAKB2luaGVyaXQJAAAAcTRyaWJib25jBAIBAAAACgExDAAAAHRy
YW5zcGFyZW5jeQQCAQAAAAoHMC4wMDc1cg8AAABzZWdtZW50X3NwYWNpbmcEAgEAAAAKB2luaGVy
aXQJAAAAcTJyaWJib250BAIBAAAACgdpbmhlcml0CQAAAHExcmliYm9udAQCAQAAAAoAGAAAAGxh
YmVsX3NlZ21lbnRfb25fc2VnbWVudAQCAQAAAAoEMC43NQ4AAABzZWdtZW50X3JhZGl1cwQCAQAA
AAoBMRYAAABsYWJlbF9zZWdtZW50X3BhcmFsbGVsBAIBAAAACgALAAAAcTNyaWJib251c2UEAgEA
AAAKB3Jvdyxjb2wPAAAAcGxhY2VtZW50X29yZGVyBAIBAAAACgEwEwAAAGxhYmVsX3RpY2tfcGFy
YWxsZWwEAgEAAAAKBWFzY2lpEwAAAHNlZ21lbnRfY29sb3Jfb3JkZXIEAgEAAAAKAA0AAABpbnRy
YV9zZWdtZW50BAIBAAAACgALAAAAcTJyaWJib251c2U=
';

ENV
tableviewer tableviewer=BAsIMTIzNDU2NzgECAgIAzIAAAAEAgEAAAAKB2luaGVyaXQJAAAAcTJyaWJib25jBAIBAAAACgdp%0Abmhlcml0CQAAAHE0cmliYm9udAQCAQAAAAoHaW5oZXJpdAkAAABxM3JpYmJvbmMEAgEAAAAKAjI0%0AFwAAAGxhYmVsX3NlZ21lbnRfZm9udF9zaXplBAIBAAAACgMzNXARAAAAc2VnbWVudF90aGlja25l%0Ac3MEAgEAAAAKAAwAAAByYXRpb19sYXlvdXQEAgEAAAAKATEJAAAAcTNyaWJib25zBAIBAAAACgEx%0ACQAAAHEycmliYm9ucwQCAQAAAAoIc2l6ZV9hc2MSAAAAcmliYm9uX2xheWVyX29yZGVyBAIBAAAA%0ACgEwFgAAAGNvbG9yX3JpYmJvbnNfYnlfdmFsdWUEAgEAAAAKBWNvdW50GwAAAHNlZ21lbnRfY29s%0Ab3JfaW50ZXJwb2xhdGlvbgQCAwAAAAoACgAKABMAAABjb250cmlidXRpb25fdHJhY2tzBAIBAAAA%0ACgh2dnZkZ3JleRAAAABsYWJlbF90aWNrX2NvbG9yBAIBAAAACgAIAAAAZW5jb2RpbmcEAgEAAAAK%0AAAsAAABxNHJpYmJvbnVzZQQCAQAAAAoBMQkAAABxMXJpYmJvbnMEAgEAAAAKBm5vcm1hbBIAAABs%0AYWJlbF9zZWdtZW50X2ZvbnQEAgEAAAAKATAOAAAAbWluX3BlcmNlbnRpbGUEAgEAAAAKAA8AAABy%0AZXZlcnNlX3JpYmJvbnMEAgEAAAAKATAJAAAAbm9ybWFsaXplBAIBAAAACgVhc2NpaQ0AAABzZWdt%0AZW50X29yZGVyBAIBAAAACgIxNhQAAABsYWJlbF90aWNrX2ZvbnRfc2l6ZQQCAQAAAAoDcm93EwAA%0AAHJpYmJvbl9jb2xvcl9zb3VyY2UEAgEAAAAKBzAuNjMtMTAHAAAAdmVyc2lvbgQCAQAAAAoHaW5o%0AZXJpdAkAAABxMXJpYmJvbmMEAgMAAAAKAAoACgALAAAAcmliYm9uX2NhcHMEAgEAAAAKAAsAAABh%0AY2Nlc3NfY29kZQQCAQAAAAoJc2l6ZV9kZXNjGQAAAHNlZ21lbnRfb3JkZXJfcHJvZ3Jlc3Npb24E%0AAgEAAAAKAAsAAABxMXJpYmJvbnVzZQQCAQAAAAoBMQkAAABxNHJpYmJvbnMEAgEAAAAKATARAAAA%0AZmFkZV90cmFuc3BhcmVuY3kEAgEAAAAKBWxpZ2h0DwAAAGxhYmVsX3RpY2tfZm9udAQCAQAAAAoG%0AbmF0aXZlEwAAAHJpYmJvbl9idW5kbGVfb3JkZXIEAgEAAAAKB2luaGVyaXQJAAAAcTNyaWJib250%0ABAIBAAAACgh2dnZkZ3JleRMAAABsYWJlbF9zZWdtZW50X2NvbG9yBAIIAAAACgAKAAoACgAKAAoA%0ACgAKAAYAAABmb3JtYXQEAgEAAAAKB2luaGVyaXQJAAAAcTRyaWJib25jBAIBAAAACgExDAAAAHRy%0AYW5zcGFyZW5jeQQCAQAAAAoHMC4wMDc1cg8AAABzZWdtZW50X3NwYWNpbmcEAgEAAAAKB2luaGVy%0AaXQJAAAAcTJyaWJib250BAIBAAAACgdpbmhlcml0CQAAAHExcmliYm9udAQCAQAAAAoAGAAAAGxh%0AYmVsX3NlZ21lbnRfb25fc2VnbWVudAQCAQAAAAoEMC43NQ4AAABzZWdtZW50X3JhZGl1cwQCAQAA%0AAAoBMRYAAABsYWJlbF9zZWdtZW50X3BhcmFsbGVsBAIBAAAACgALAAAAcTNyaWJib251c2UEAgEA%0AAAAKB3Jvdyxjb2wPAAAAcGxhY2VtZW50X29yZGVyBAIBAAAACgEwEwAAAGxhYmVsX3RpY2tfcGFy%0AYWxsZWwEAgEAAAAKBWFzY2lpEwAAAHNlZ21lbnRfY29sb3Jfb3JkZXIEAgEAAAAKAA0AAABpbnRy%0AYV9zZWdtZW50BAIBAAAACgALAAAAcTJyaWJib251c2U%3D%0A