git-svn-id: file:///home/git/hedgehog.fhcrc.org/bioconductor/trunk/madman/Rpacks/Gviz@67723 bc3139a8-67e5-0310-9ffc-ced21a209358
... | ... |
@@ -4,6 +4,8 @@ |
4 | 4 |
%\VignettePackage{Gviz} |
5 | 5 |
\documentclass[11pt]{article} |
6 | 6 |
|
7 |
+\usepackage[utf8]{inputenc} |
|
8 |
+ |
|
7 | 9 |
\SweaveOpts{keep.source=FALSE,pdf=TRUE,eps=FALSE} |
8 | 10 |
|
9 | 11 |
\usepackage{hyperref} |
... | ... |
@@ -157,7 +159,7 @@ gen <- genome(cpgIslands) |
157 | 159 |
atrack <- AnnotationTrack(cpgIslands, name="CpG") |
158 | 160 |
@ |
159 | 161 |
|
160 |
-Please note that the \Rfunction{AnnotationTrack} constructor (as mo�st |
|
162 |
+Please note that the \Rfunction{AnnotationTrack} constructor (as most |
|
161 | 163 |
constructors in this package) is fairly flexible and can accomodate |
162 | 164 |
many different types of inputs. For instance, the start and end |
163 | 165 |
coordinates of the annotation features could be passed in as |
... | ... |
@@ -364,21 +366,20 @@ options. |
364 | 366 |
|
365 | 367 |
\section{Plotting parameters} |
366 | 368 |
|
367 |
-Although not implicitely told, we have already made use of the |
|
368 |
-plotting parameter facilities in the \mgg package, or, as we will call |
|
369 |
-them from now on, the 'display parameters'. Display parameters are |
|
370 |
-properties of individual track objects (i.e., of any object inheriting |
|
371 |
-from the base \Rclass{GdObject} class). They can either be set during |
|
372 |
-object instantiation as additional arguments to the constructor |
|
373 |
-functions or, for existing track objects, using the |
|
369 |
+Although not implicitely mentioned before, we have already made use of |
|
370 |
+the plotting parameter facilities in the \mgg package, or, as we will |
|
371 |
+call them from now on, the 'display parameters'. Display parameters |
|
372 |
+are properties of individual track objects (i.e., of any object |
|
373 |
+inheriting from the base \Rclass{GdObject} class). They can either be |
|
374 |
+set during object instantiation as additional arguments to the |
|
375 |
+constructor functions or, for existing track objects, using the |
|
374 | 376 |
\Rfunction{displayPars} replacement method. In the former case, all |
375 | 377 |
named arguments that can not be matched to any of the constructor's |
376 | 378 |
formal arguments are considered to be display paramters, regardless of |
377 |
-their type or whether they are defined for a particular track |
|
378 |
-class or not. The following code example rebuilds our |
|
379 |
-\Rclass{GeneRegionTrack} object with a bunch of display parameters set |
|
380 |
-and demonstrates the use of the \Rfunction{displayPars} accessor and |
|
381 |
-replacement methods. |
|
379 |
+their type or whether they are defined for a particular track class or |
|
380 |
+not. The following code example rebuilds our \Rclass{GeneRegionTrack} |
|
381 |
+object with a bunch of display parameters and demonstrates the use of |
|
382 |
+the \Rfunction{displayPars} accessor and replacement methods. |
|
382 | 383 |
|
383 | 384 |
<<displayPars1, fig=TRUE, width=7.5, height=3>>= |
384 | 385 |
grtrack <- GeneRegionTrack(geneModels, genome=gen, chromosome=chr, name="Gene Model", |
... | ... |
@@ -396,14 +397,14 @@ display parameters for a single plotting operation (rather than the |
396 | 397 |
permanent setting in the track object) by passing in additional |
397 | 398 |
arguments to the \Rfunction{plotTracks} function. We have already made |
398 | 399 |
use of this feature in the previous data plotting type example. It is |
399 |
-worth mentioning that all display parameters that are passed along |
|
400 |
-with the \Rfunction{plotTracks} function apply to all track objects in |
|
401 |
-the plot. For some track objects a particular display parameter may |
|
402 |
-not make any sense, and in that case it is simply ignored. Also, the settings |
|
403 |
-only apply for one single plotting operations and will not be retained |
|
404 |
-in the plotted track objects. They do however get precedence over the |
|
405 |
-object-internal parameters. The following line of code exemplifies |
|
406 |
-this behaviour. |
|
400 |
+worth mentioning that all display parameters which are passed along |
|
401 |
+with the \Rfunction{plotTracks} function apply to \emph{all} track |
|
402 |
+objects in the plot. For some objects classes a particular display |
|
403 |
+parameter may not make any sense, and in that case it is simply |
|
404 |
+ignored. Also, the settings only apply for one single plotting |
|
405 |
+operation and will not be retained in the plotted track objects. They |
|
406 |
+do however get precedence over the object-internal parameters. The |
|
407 |
+following line of code exemplifies this behaviour. |
|
407 | 408 |
|
408 | 409 |
<<displayPars2, fig=TRUE, width=7.5, height=3>>= |
409 | 410 |
plotTracks(list(itrack, gtrack, atrack, grtrack), from=lim[1]-1000, to=lim[2], |
... | ... |
@@ -413,14 +414,14 @@ plotTracks(list(itrack, gtrack, atrack, grtrack), from=lim[1]-1000, to=lim[2], |
413 | 414 |
In order to make full use of the flexible parameter system we need to |
414 | 415 |
know which display parameters control which aspect of which track |
415 | 416 |
class. The obvious source for this information are the man pages of |
416 |
-the respective track classes, which list all available parameters and |
|
417 |
-a short description of their effect and default values in the |
|
418 |
-\Robject{Display Parameters} section. Alternatively, we can use the |
|
419 |
-\Rfunction{availableDisplayPars} function, which prints out the |
|
420 |
-available parameters for a class in a list-like structure. The single |
|
421 |
-argument to the function is either a class name of a track object |
|
422 |
-class, or the object itself, in which case its class is automatically |
|
423 |
-detected. |
|
417 |
+the respective track classes, which list all available parameters |
|
418 |
+along with a short description of their effect and default values in |
|
419 |
+the \Robject{Display Parameters} section. Alternatively, we can use |
|
420 |
+the \Rfunction{availableDisplayPars} function, which prints out the |
|
421 |
+available parameters for a class as well as their default values in a |
|
422 |
+list-like structure. The single argument to the function is either a |
|
423 |
+class name of a track object class, or the object itself, in which |
|
424 |
+case its class is automatically detected. |
|
424 | 425 |
|
425 | 426 |
<<displayPars3>>= |
426 | 427 |
dp <- availableDisplayPars(grtrack) |