59
59
Perl 5.8.x, or newer, is highly recommended. In addition to the core
60
modules that come with your Perl distribution, the following CPAN
60
modules that come with your Perl distribution, some CPAN modules are required.
83
62
On UNIX systems, for a list of modules required by Circos, run
194
177
> ln -s /usr/bin/env env
196
Now try creating an image from one of the tutorials.
179
Now try creating the example image
199
> bin/circos -conf tutorials/2/2/circos.conf
201
If everything goes well, the program should terminate with a line
203
created image at /tmp/circos-tutorial.png
205
To get some verbose reporting, use
207
> bin/circos -conf tutorials/2/2/circos.conf -debug
209
Please see L<http://www.circos.ca> for documentation. There are a large number
210
of tutorials that described how the configuration files are formatted.
183
> ../bin/circos -conf etc/circos.conf
185
To get some verbose reporting about file I/O , use
187
> ../bin/circos -conf etc/circos.conf -debug_group io,summary
189
Please see L<http://www.circos.ca> for documentation. There are a
190
large number of tutorials that described how the configuration files
191
are formatted. Tutorials need to be downloaded separately.
214
There are several helper scripts located in tools/ that are designed
195
There are several helper scripts, available separately, that are designed
215
196
to aid you in processing your data.
217
198
Many of these involve manipulating link files. These tools independent
218
199
scripts and are covered in Tutorial 9.
220
L<http://circos.ca/tutorials/lessons/utilities>
201
http://circos.ca/tutorials/lessons/utilities
222
203
The tools can be downloaded independently. Note that the stand-alone
223
204
tools distribution may contain scripts that are newer than those
258
GD does not draw rotated text correctly when the font size is
259
small. For example, using a font size of 6pt, text drawn an an angle
260
is drawn with letters upright. If you see this, increase the font size
239
GD does not draw rotated text correctly when the font size is small
240
for certain fonts. For example, using a font size of 6pt, text drawn
241
an an angle is drawn with letters upright. If you see this, increase
242
the font size of the text.
244
Fonts with which this problem occurs are
247
CMUTypewriter-Regular
249
For this reason, TTF versions of these fonts are used, rather than OTF.
264
251
3. INSTALLATION PROBLEMS
266
253
3.a Missing modules
255
http://www.circos.ca/documentation/tutorials/configuration/perl_and_modules/
268
257
In order to run Circos you may need to install some modules from CPAN
269
258
(www.cpan.org). You will need the modules listed at L<http://www.circos.ca/software/requirements>.
339
328
4.b Typical errors and how to fix them
341
4.b.1 Numerical parameter units
343
Many numerical parameters in the .conf files require that you specify
344
a unit. For a given parameter, one or more of these units may be required
346
p - absolute size in pixels
347
r - relative size, with the comparator being context sensitive
348
e.g. relative tick size is relative to ideogram thickness
349
e.g. relative tick label offset is relative to tick size
350
u - chromosome units, as defined by chromosomes_unit
351
b - bases, the natural unit along the ideogram
352
n - no unit, explicitly stated
354
If you receive an error message of the kind
356
The parameter [ideogram/spacing/break_style/thickness] value [0.25] does not have
357
the correct unit [saw n], which should be one of r,p at bin/circos line 3410
358
main::unit_validate(0.25, 'ideogram/spacing/break_style/thickness', 'r', 'p') called atbin/circos line 3559
359
main::draw_axis_break('HASH(0x8a81d10)') called at bin/circos line 872
361
Then you have the wrong unit. Here the parameter at fault is
363
ideogram/spacing/break_style/thickness
372
It is defined to be 0.25 (no unit) but requires that it have a unit of
373
either "r" (relative) or "p" (absolute).
375
As Circos matures, and the configuration file syntax stabilizes, I am
376
striving to standardize the requirement for units for all
377
parameters. Previous versions were more tolerant and attempted to
378
naively determine the unit automatically (e.g. if value was <1 then
379
the unit was assumed relative) and you may find that after upgrading
380
to a new version of Circos your old files are creating errors. Just
381
add the units and you're good to go.
330
4.b.1 Dealing with errors
332
http://mkweb.bcgsc.ca/dev/circos/documentation/tutorials/configuration/errors/
383
334
4.b.2 No text in figures
397
348
http://search.cpan.org/dist/GD/
350
This issue comes up a lot. Circos has this to say about it
352
circos -fake font,ttf
354
and many threads about it have been created on the message boards
356
http://groups.google.com/group/circos-data-visualization/browse_thread/thread/c893b8b612c2c5cf
361
2012 Feb 20 - added link to thread about TTF support and a command to fake TTF font error
363
2012 Feb 5 - modified note on errors, added reference to external tutorials
402
365
2011 Jul 25 - split Circos, tutorials and tools into separate archives
404
367
2011 Jun 04 - started keeping track of history