Contribute a tool

GenoCAT is a crowdsourced resource. Data visualization tool developers can add their own tools to GenoCAT or edit any errors users may come across when browsing through tool pages. Tool are organized into Markdown files and can be accessed via our GitHub repository. You can find the Markdown files for all tools on the website in this folder.

To add a new tool, first fork our repository on GitHub. Using template.md, create a Markdown file for your tool following the instruction below and upload it into “_tools”.

The following describes each parameter in the template. Do not change the first parameter. It must remain ‘layout: tool’.

Please follow the outlined instructions (e.g., brackets and quotations) when indicated. This allows for multiple characteristics if your tool supports multiple characteristics and should be indicated as such: [“linear”, “circular”]. If a parameter doesn’t apply for your tool, leave it blank.

title:

Provide the name of the tool.

developer_github_account:

Provide your GitHub username.

paper:

Provide a link to the tool’s paper or preprint.

paper_title:

Provide the title of the paper, in quotation marks (e.g., “Circos: an information aesthetic for comparative genomics”).

doi:

Provide the publication or preprint DOI.

browser:

Provide a link to the tool itself. This could be a website or GitHub repository.

abstract:

Provide the abstract for the tool’s paper, in quotation marks (e.g. “We created a visualization tool called Circos to facilitate the identification and analysis of similarities and differences arising from comparisons of genomes…”).

citation:

Provide the citation for the tool’s paper, in quotation marks (e.g. “Krzywinski M, Schein J, Birol I, Connors J, Gascoyne R, Horsman D, et al. Circos: an information aesthetic for comparative genomics. Genome Res. 2009;19: 1639–1645.”).

feature_type:

Provide the segment/point, sparse/contiguous type of the tool, based on the following descriptions.

Segment vs. point:

Features that only cover one nucleotide are referred to as “point” type features, while features covering more than one nucleotide are called “segment” features.

 

Sparse vs. contiguous:

“Sparse” type feature sets contain gaps between features, while “contiguous” feature sets cover the entire genome.

Choose one or more types from the following list: [“segment sparse”, “point contiguous”, “point sparse”, “segment contiguous”], and use brackets and quotations (e.g., [“segment sparse”])

interconnection_type:

Provide the interconnection type of the tool, based on the following definitions.

None:

No interconnection between sequences

 

Within:

Interconnections that connect features within a sequence

 

Between:

Interconnections that connect features between sequences

Choose from the following interconnection types: [“no”, “within”, “between”], and use brackets and quotations (e.g. [“within”, “between”])

genome_layout:

Provide the layout of the genome, according to the following definitions.

Linear:

The genome is laid out linearly.

 

Circular:

class="run-in" The genome is represented as a circle.

 

Spatial:

Spatial layouts display sequences in a 3-dimensional space.

 

Space-filling:

The space-filling curve displays a more global overview of the genome while maintaining the spatial distribution of features, for example, using a Hilbert or other space-filling curve.

Choose from the following interaction types: [“linear”, “circular”, “spatial”, “spacefilling”], and use brackets and double quotations (e.g. [“linear”])

partition:

Provide the partition, according to the following definitions.

Contiguous:

Segments, typically individual chromosomes, of the genome are joined together end-to-end.

 

Segregated:

Segments, typically individual chromosomes, of the genome are displayed separately.

Choose from the following partition types: [“contiguous”, “segregated”], and use brackets and double quotations (e.g. [“contiguous”])

abstraction:

Abstraction allows for the reduction of space in order to concentrate on specific regions of the genome.

No:

Describes tools where no part of the genome is abstracted or removed.

 

Partial:

Describes tools where parts of the genome is abstracted or removed

 

Complete:

Describes tools where all of the genome is abstracted or removed

Choose from the following formats: [“no”, “partial”, “complete”] and use brackets and double quotations.

arrangement:

Different genomic arrangements can be used to better compare and visualize genomic features.

Linear parallel:

Describes multiple linear visualizations laid in parallel

 

Linear serial:

Describes multiple linear genomic segments laid side by side

 

Linear orthogonal:

Describes multiple linear genomic segments laid in a 90 degree. Examples include in a heatmap fashion.

 

Circular Parallel:

Describes circular genomic regions laid in outer as and inner rings.

 

Circular Serial:

Describes circular genomic regions laid side by side

 

Choose from the following arrangement types: [“linear parallel”, “linear serial”, “linear orthogonal”, “circular parallel”, “circular serial”] and use brackets and double quotations

view:

A view describes a set of one or multiple aligned tracks. Multiple views allow for visualizations with multiple scales and foci. Choose from the following viewtypes: [“single”, “multiple”].

scale:

Single scale visualizations display a genome from a single perspective - one size, while multiple scale visualization allows for visualizing data from multiple perspectives/sizes at once. Choose from the following scale types: [“single”, “multiple”].

focus:

A single focus is similar to sliding a window across the genome. Only the region in this window can be analyzed. Multiple foci enable users to look at distinct segments of a genome in parallel and compare features that are dispersed across the genome. Choose from the following focus types: [“single”, “multiple”].

coordinate_systems:

Tools can allow the visualization of a single coordinate system at the time or multiple simultaneously. Choose from the following coordinate systems: [“single”, “multiple”].

access_format:

Indicate how your tool can be accessed (through a web link, software, package, etc). Choose from the following formats: [“web application”, “standalone app”, “programming library”] and use brackets and double quotations.

user_documentation_availability:

Indicate whether user documentation for your tool is provided in the following format: [“yes”, “no”]

user_documentation:

Provide a URL link to tool documentation

pub_year:

Provide your tool’s publication year

license:

Indicate your tool’s license (e.g. MIT, GPL)

license_form:

Indicate whether you tool’s licensing is open source or commercial using the following format [“open source”, “commercial”]

supported_files:

Indicate which of the files your tool supports out of [“bed”, “fasta”, “sambamcram”, “vcf”, “notapplicable”, “txttab”, “other”]

image:

Provide a file path to the image in the following format /assets/[TOOLNAME].png

image_location:

Provide the image URL, if applicable

notes:

Any further notes necessary

For more information on taxonomy parameters, visit the Taxonomy page

Once submitted, the pull request will be reviewed by the GenoCAT team. For questions, please contact nils@hms.harvard.edu.