apt-copynumber-analysis is a component of the CN5 suite of applications for finding de novo copy number changes and Loss of Heterozygosity (LOH) on a per sample basis with respect to a reference set of samples. The copy number algorithm it implements assumes that the reference set comprises a mix of normal human males (with XY chromosomes) and normal human females (with XX chromosomes). The algorithms assume that in this reference for each autosomal marker (SNP or Copy Number probe) the predominant Copy Number is 2, and for the sex chromosomes the copy number is determined by the gender.
apt-copynumber-analysis implements the portion of the workflow that generates cn-state, loh, and gaussian smooth values for each probe set.
Most users will probably want to use apt-copynumber-workflow which provides a complete copynumber analysis from CEL files to CNCHP files.
The basic requirements for a run of apt-copynumber-analysis are:
On unix systems a basic command using the default parameters to do a batch run on GenomeWide SNP 6.0 data would look like:
apt-copynumber-analysis \
--array-name GenomeWideSNP_6 \
--text-output true \
--set-analysis-name Test \
--log2ratio-file input_directory/Test.NA06985_GW6_C.cel.a5 \
--out-dir output_directory_name
./apt-copynumber-analysis \
-v 3 \
--geno-qc-file test-generated/GenomeWideSNP_6/component_6_cels/apt-geno-qc.txt \
--cnchp-output true \
--cychp-output false \
--text-output false \
--log2ratio-file test-generated/GenomeWideSNP_6/component_6_cels/CN5.NA07019_GW6_C.CEL.a5 \
-our-dir test-generated/GenomeWideSNP_6/component_6_cels
options:
Common Options (not used by all programs)
-h, --help Display program options and extra
documentation about possible analyses. See
-explain for information about a specific
operation. [default 'false']
-v, --verbose How verbose to be with status messages 0 -
quiet, 1 - usual messages, 2 - more
messages. [default '1']
--console-off Turn off the default messages to the
console but not logging or sockets.
[default 'false']
--use-socket Host and port to print messages over in
localhost:port format [default '']
--version Display version information. [default
'false']
-f, --force Disable various checks including chip
types. Consider using --chip-type option
rather than --force. [default 'false']
--throw-exception Throw an exception rather than calling
exit() on error. Useful for debugging. This
option is intended for command line use
only. If you are wrapping an Engine and
want exceptions thrown, then you should
call Err::setThrowStatus(true) to ensure
that all Err::errAbort() calls result in an
exception. [default 'false']
--analysis-files-path Search path for analysis library files.
Will override AFFX_ANALYSIS_FILES_PATH
environment variable. [default '']
--xml-file Input parameters in XML format (Will
override command line settings). [default
'']
--temp-dir Directory for temporary files when working
off disk. Using network mounted drives is
not advised. When not set, the output
folder will be used. The defaut is
typically the output directory or the
current working directory. [default '']
-o, --out-dir Directory for output files. Defaults to
current working directory. [default '.']
--log-file The name of the log file. Generally
defaults to the program name in the out-dir
folder. [default '']
Engine Options (Not used on command line)
--command-line The command line executed. [default '']
--exec-guid The GUID for the process. [default '']
--program-name The name of the program [default '']
--program-company The company providing the program [default
'']
--program-version The version of the program [default '']
--program-cvs-id The CVS version of the program [default '']
--version-to-report The version to report in the output files.
[default '']
--free-mem-at-start How much physical memory was available when
the engine run started. [default '0']
--meta-data-info Meta data in key=value pair that will be
output in headers. [default '']
Input Options
--log2ratio-file Log2Ratio file. [default '']
Analysis Options
-a, --analysis String representing analysis pathway
desired. [default '']
--gc-correction-bin-count The number of bins to use for GC content.
[default '25']
Advanced Options
--xChromosome X Chromosome. [default '24']
--yChromosome Y Chromosome. [default '25']
Execution Control Options
--mem-usage How many MB of memory to use for this run.
[default '0']
Additional CNAnalysisEngine Options
--geno-qc-file The file output from GenoQC. [default '']
--cyto2 Processing CYTO2 chip. [default 'false']
--array-name Array name or type to use. [default '']
--set-analysis-name Analysis name to use as prefix for output
files. [default '']
--text-output Output data in ASCII text format in
addition to calvin format. [default
'false']
--cnchp-output Report CNCHP files [default 'true']
--cychp-output Report CYCHP files [default 'false']
--time-start The time the engine run was started
[default '']
--time-end The time the engine run ended [default '']
--time-run-minutes The run time in minutes. [default '']
--analysis-guid The GUID for the analysis run. [default '']
Q. Some question? For example:
example
A. The answer.
1.7.1