chicAggregateStatistic

chicAggregateStatistic is a preprocessing tool for chicDifferentialTest. It takes two consecutive viewpoint files and one target file and creates one file containing all locations which should be tested for differential interactions. Either one target file for two consecutive viewpoint files or one target file for all viewpoints is accepted.

An example usage is:

$ chicAggregateStatistic –interactionFile viewpoint1.bed viewpoint2.bed –targetFile targets.bed –outFileNameSuffix aggregated.bed

and this will create one file: viewpoint1_viewpoint2_aggregated.bed

A second mode is the batch processing mode, for this you need a file containing the names of the viewpoint files (generated by chicViewpoint via –writeFileNamesToFile), a folder containing them, a target list file containing the name of all target files and a folder containing them (created by chicSignificantInteractions):

$ chicAggregateStatistic –interactionFile viewpoint_names.txt –targetFile target_names.txt –interactionFileFolder viewpointFilesFolder –targetFileFolder targetFolder –batchMode –threads 20 –outFileNameSuffix aggregated.bed

If no –targetFileFolder in batch mode is given, it is assumed the –targetFile should be used for all viewpoints.

usage: chicAggregateStatistic --interactionFile INTERACTIONFILE
                              [INTERACTIONFILE ...]
                              [--targetFile TARGETFILE [TARGETFILE ...]]
                              [--outFileNameSuffix OUTFILENAMESUFFIX]
                              [--interactionFileFolder INTERACTIONFILEFOLDER]
                              [--targetFileFolder TARGETFILEFOLDER]
                              [--outputFolder OUTPUTFOLDER]
                              [--writeFileNamesToFile WRITEFILENAMESTOFILE]
                              [--batchMode] [--threads THREADS] [--help]
                              [--version]

Required arguments

--interactionFile, -if

path to the interaction files which should be used for aggregation of the statistics.

--targetFile, -tf

path to the target files which contains the target regions to prepare data for differential analysis.

Optional arguments

--outFileNameSuffix, -suffix

File name suffix to save the result.

Default: “_aggregate_target.bed”

--interactionFileFolder, -iff

Folder where the interaction files are stored in. Applies only for batch mode.

Default: “.”

--targetFileFolder, -tff

Folder where the interaction files are stored in. Applies only for batch mode.

--outputFolder, -o

Output folder of the files.

Default: “aggregatedFiles”

--writeFileNamesToFile, -w

Default: “aggregatedFilesBatch.txt”

--batchMode, -bm

The given file for –interactionFile and or –targetFile contains a list of the to be processed files.

Default: False

--threads, -t

Number of threads. Using the python multiprocessing module.

Default: 4

--version

show program’s version number and exit