Syntax:

-binlc combinetype <"binsize" binsize | "nbins" nbins> ["firstbinshift" firstbinshift] timetype

Example 1.
$ ./vartools -i EXAMPLES/2 -header \
    -binlc 1 binsize 0.01 0 \
    -o EXAMPLES/OUTDIR1/2.bin.txt

#Name
EXAMPLES/2

Median-bin the light curve EXAMPLES/2 in time. A binsize of 0.01 days is used. The output time for each bin is taken to be the center of the bin. After binning the light curve, the -o command outputs the binned light curve to the file EXAMPLES/OUTDIR1/2.bin.txt

Example Binned Light Curve

Fig 1. Binned Light Curve from Example 1.

Example 2.
$ ./vartools -i EXAMPLES/2 -header \
    -LS 0.1 10. 0.1 1 0 \
    -Phase ls \
    -binlc 1 nbins 100 0 \
    -o EXAMPLES/OUTDIR1/2.phasebin.txt

#Name LS_Period_1_0 Log10_LS_Prob_1_0 LS_SNR_1_0
EXAMPLES/2     1.23440877 -704.49194   58.45119

A slightly more involved example. First the -LS command is used to apply the Lomb-Scargle period-finding algorithm to the light curve EXAMPLES/2 (the period is searched between 0.1 and 10.0 days; the scan is done at a frequency resolution of 0.1/T where T=31.1d is the time-span of the LC; only 1 peak in the periodogram is found, and the periodogram is not output). The light curve is then phased using the period identified by the -LS command. We then bin the phased light curve as in Example 1, though here we specify the number of bins to use rather than the size of the bins. The phase-binned light curve is then output to the file EXAMPLES/OUTDIR1/2.phasebin.txt.

Example Phase-Binned Light Curve

Fig 2. Phase-Binned Light Curve from Example 2.