The purpose of biocViews is create HTML pages that categorize packages in a Bioconductor package repository according to terms, or views, in a controlled vocabulary. The fundamental resource is the VIEWS file placed at the root of a repository. This file contains the complete DESCRIPTION file contents for each package along with additional meta data describing the location of package artifacts such as archive files for different platforms and vignettes.
The standard behavior of the view generation program is to query the repository over the internet. This package includes a static sample VIEWS file so that the examples in this document can run without internet access.
We use dot to describe the vocabulary. For details on the dot
syntax, see http://www.graphviz.org/doc/info/lang.html.
vocabFile <- system.file("dot/biocViewsVocab.dot", package="biocViews")
cat(readLines(vocabFile)[1:20], sep="\n")## /* Bioc Views Vocabular Definition in dot format */
##
## /* How To Process this file:
## 1. Use dot2gxl from graphviz to transform into GXL format.
## dot2gxl biocViewsVocab.dot > biocViewsVocab.gxl
## 2. use graph::fromGXL to obtain a graphNEL object
##
## */
##
## digraph G {
##
## /****************************************************************************
## * Software *
## ****************************************************************************/
## BiocViews -> Software;
##
## /* Software -> AssayDomain */
## Software -> AssayDomain;
## AssayDomain -> aCGH;
## AssayDomain -> CellBasedAssays;cat("...\n")## ...The dot description is transformed to a GXL document using dot2gxl, a
tool included in the graphviz distribution. The GXL is then converted to
a graphNEL instance using fromGXL from the graph package. There is
a helper script in the root of the biocViews package called
updateVocab.sh that automates the update process if the required tools
are available. The script will also attempt to dump the ontology graph
into a local SQLite database using tools from DBI and RSQLite. The
information in this database can be used to create a dynamic HTML
representation of the graph by means of a PHP script.
The definition of the vocabulary lacks a notion of order. Since the purpose of the vocabulary is primarily for display, a valuable improvement would be to use graph attributes to allow the ordering of the terms.
Another missing piece is a place to put a text description of each term. This could also be achieved using graph attributes.
To add a new term to the vocabulary:
dot/biocViewsVocab.dot and add the desired term. Note that terms cannot contain spaces and that the underscore character, _, should be used instead.data(biocViewsVocab) and check that the term is a node of the graph instance.This is for BioConductor web administrator:
svn update.biocViews./home/biocadmin/bin/prepareRepos-*.sh and /home/biocadmin/bin/pushRepos-*.sh.To generate a list of BiocViews objects that can be used to generate HTML views, you will need the repository URL and a graph representation of the vocabulary.
There are three main Bioconductor package repositories: a software
repository containing analytic packages, an annotation data repository,
and an experiment data repository. The vocabulary of terms has a single
top-level node, all other nodes have at least one parent. The top-level
node, BiocViews, has three children that correspond to the three main
Bioconductor repositories: Software, AnnotationData, and
ExperimentData. Views for each repository are created separately using
getBiocSubViews. Below, we demonstrate how to build the Software set
of views.
data(biocViewsVocab)
reposPath <- system.file("doc", package="biocViews")
reposUrl <- paste("file://", reposPath, sep="")
biocViews <- getBiocSubViews(reposUrl, biocViewsVocab, topTerm="Software")
print(biocViews[1:2])## $Software
## Bioconductor View: Software
## Parent Views:
## [1] "BiocViews"
## Subviews:
## [1] "AssayDomain" "Technology" "ResearchField"
## [4] "BiologicalQuestion" "WorkflowStep" "WorkflowManagement"
## [7] "StatisticalMethod" "Infrastructure" "ShinyApps"
## Contains packages:
## [1] "Ruuid" "aCGH" "affycomp" "affydata" "affypdnn"
## [6] "affxparser" "affylmGUI" "affy"
##
## $AssayDomain
## Bioconductor View: AssayDomain
## Parent Views:
## [1] "Software"
## Subviews:
## [1] "aCGH" "CellBasedAssays" "ChIPchip"
## [4] "CopyNumberVariation" "CpGIsland" "DNAMethylation"
## [7] "ExonArray" "GeneExpression" "GeneticVariability"
## [10] "SNP" "Transcription"
## Contains packages:
## <no packages>To query the currently available vocabulary terms, use function
getSubTerms on the graphNEL object biocViewsVocab. The second
argument of this function takes a character of the base term for which
all subterms should be returned. For a complete list use
term="BiocViews".
getSubTerms(biocViewsVocab, term="Technology")## [1] "Technology" "Sequencing"
## [3] "Microarray" "FlowCytometry"
## [5] "MassSpectrometry" "qPCR"
## [7] "MicrotitrePlateAssay" "SAGE"
## [9] "CRISPR" "SingleCell"
## [11] "Spatial" "ddPCR"
## [13] "AnnotationHubSoftware" "ExperimentHubSoftware"
## [15] "ATACSeq" "DNASeq"
## [17] "DNaseSeq" "RiboSeq"
## [19] "RNASeq" "ChIPSeq"
## [21] "RIPSeq" "MethylSeq"
## [23] "ExomeSeq" "miRNA"
## [25] "SangerSeq" "SmallRNA"
## [27] "Microbiome" "WholeGenome"
## [29] "DenovoGenome" "TargetedResequencing"
## [31] "DenovoTranscriptome" "MicrobialStrain"
## [33] "HiC" "PooledScreens"
## [35] "MNaseSeq" "LongRead"
## [37] "MultiChannel" "OneChannel"
## [39] "TwoChannel" "MethylationArray"
## [41] "GenotypingArray" "MicroRNAArray"
## [43] "mRNAMicroarray" "ChipOnChip"
## [45] "ReversePhaseProteinArray" "TissueMicroarray"
## [47] "ProprietaryPlatforms" "ImagingMassSpectrometry"By default, the set of HTML views will link to package description pages located in the html subdirectory of the remote repository.
viewsDir <- file.path(tempdir(), "biocViews")
dir.create(viewsDir)
writeBiocViews(biocViews, dir=viewsDir)## NULLdir(viewsDir)[1:2]## [1] "ATACSeq.html" "Agroinformatics.html"