Skip to content

MAVIS standard input file format

These requirements pertain to the columns of input files from the various tools you want to merge. The input files should be tab-delimited text files. Comments at the top of may be included. Comments should begin with hash marks. They will be ignored when the file is read

## This is a comment

The header row contains the column names and is the first row following the comments (or the first row if no comments are included).

## This is a comment
## this is another comment
# this is also a comment
This    Is  The Header

A simple input file might look as follows

## File created at: 2018-01-02
## Generated by: MAVIS v1.0.0
break1_chromosome  break1_position_start   break1_position_end break2_chromosome break2_position_start break2_position_end
X   1234    1234    X   77965   77965

Required Columns

Optional Columns

Optional Columns that are not given as input will be added with default (or command line parameter options) during the clustering stage of MAVIS as some are required for subsequent pipeline steps

  • break1_strand (defaults to not-specified during clustering)
  • break1_orientation (expanded to all possible values during clustering)
  • break2_strand (defaults to not-specified during clustering)
  • break2_orientation (expanded to all possible values during clustering)
  • opposing_strands (expanded to all possible values during clustering)
  • stranded (defaults to False during clustering)
  • library (defaults to command line library parameter during clustering)
  • protocol (defaults to command line protocol parameter during clustering)
  • tools (defaults to an empty string during clustering)

Summary by Pipeline Step

The different pipeline steps of MAVIS have different input column requirements. These are summarized below (for the pipeline steps which can act as the pipeline start)

column name cluster annotate validate
break1_chromosome
break1_position_start
break1_position_end
break2_chromosome
break2_position_start
break2_position_end
break1_strand
break1_orientation
break2_strand
break2_orientation
opposing_strands
stranded
library
protocol
tools
event_type

Some native tool outputs are supported and have built in methods to convert to the above format. Any unsupported tools can be used as long as the user converts the tools native output to match the above format.