.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH MACS2_RANDSAMPLE "1" "January 2023" "macs2 randsample 2.2.7.1" "User Commands"
.SH NAME
macs2_randsample \- Model\-based Analysis for ChIP\-Sequencing
.SH DESCRIPTION
usage: macs2 randsample [\-h] \fB\-i\fR IFILE [IFILE ...] (\fB\-p\fR PERCENTAGE | \fB\-n\fR NUMBER)
.TP
[\-\-seed SEED] [\-o OUTPUTFILE] [\-\-outdir OUTDIR]
[\-s TSIZE]
[\-f {AUTO,BAM,SAM,BED,ELAND,ELANDMULTI,ELANDEXPORT,BOWTIE,BAMPE,BEDPE}]
[\-\-buffer\-size BUFFER_SIZE] [\-\-verbose VERBOSE]
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-i\fR IFILE [IFILE ...], \fB\-\-ifile\fR IFILE [IFILE ...]
Alignment file. If multiple files are given as '\-t A B
C', then they will all be read and combined. Note that
pair\-end data is not supposed to work with this
command. REQUIRED.
.TP
\fB\-p\fR PERCENTAGE, \fB\-\-percentage\fR PERCENTAGE
Percentage of tags you want to keep. Input 80.0 for
80%. This option can't be used at the same time with
\fB\-n\fR/\-\-num. REQUIRED
.TP
\fB\-n\fR NUMBER, \fB\-\-number\fR NUMBER
Number of tags you want to keep. Input 8000000 or 8e+6
for 8 million. This option can't be used at the same
time with \fB\-p\fR/\-\-percent. Note that the number of tags
in output is approximate as the number specified here.
REQUIRED
.TP
\fB\-\-seed\fR SEED
Set the random seed while down sampling data. Must be
a non\-negative integer in order to be effective.
DEFAULT: not set
.TP
\fB\-o\fR OUTPUTFILE, \fB\-\-ofile\fR OUTPUTFILE
Output BED file name. If not specified, will write to
standard output. Note, if the input format is BAMPE or
BEDPE, the output will be in BEDPE format. DEFAULT:
stdout
.TP
\fB\-\-outdir\fR OUTDIR
If specified all output files will be written to that
directory. Default: the current working directory
.TP
\fB\-s\fR TSIZE, \fB\-\-tsize\fR TSIZE
Tag size. This will override the auto detected tag
size. DEFAULT: Not set
.TP
\fB\-f\fR {AUTO,BAM,SAM,BED,ELAND,ELANDMULTI,ELANDEXPORT,BOWTIE,BAMPE,BEDPE}, \fB\-\-format\fR {AUTO,BAM,SAM,BED,ELAND,ELANDMULTI,ELANDEXPORT,BOWTIE,BAMPE,BEDPE}
Format of tag file, "AUTO", "BED" or "ELAND" or
"ELANDMULTI" or "ELANDEXPORT" or "SAM" or "BAM" or
"BOWTIE" or "BAMPE" or "BEDPE". The default AUTO
option will macs2 randsample decide which format the
file is. Please check the definition in README file if
you choose ELAND/ELANDMULTI/ELANDEXPORT/SAM/BAM/BOWTIE
or BAMPE/BEDPE. DEFAULT: "AUTO"
.TP
\fB\-\-buffer\-size\fR BUFFER_SIZE
Buffer size for incrementally increasing internal
array size to store reads alignment information. In
most cases, you don't have to change this parameter.
However, if there are large number of
chromosomes/contigs/scaffolds in your alignment, it's
recommended to specify a smaller buffer size in order
to decrease memory usage (but it will take longer time
to read alignment files). Minimum memory requested for
reading an alignment file is about # of CHROMOSOME *
BUFFER_SIZE * 8 Bytes. DEFAULT: 100000
.TP
\fB\-\-verbose\fR VERBOSE
Set verbose level. 0: only show critical message, 1:
show additional warning message, 2: show process
information, 3: show debug messages. If you want to
know where are the duplicate reads, use 3. DEFAULT:2