README for the GREAT3 "shear only" truth tables
===============================================

The tarball great3_shear_only_truth.tar will unpack to make the following files:

    shear_only_truth-control-ground-constant.tar.gz
    shear_only_truth-control-ground-variable.tar.gz
    shear_only_truth-control-space-constant.tar.gz
    shear_only_truth-control-space-variable.tar.gz
    shear_only_truth-full-ground-constant.tar.gz
    shear_only_truth-full-ground-variable.tar.gz
    shear_only_truth-full-space-constant.tar.gz
    shear_only_truth-full-space-variable.tar.gz
    shear_only_truth-multiepoch-ground-constant.tar.gz
    shear_only_truth-multiepoch-ground-variable.tar.gz
    shear_only_truth-multiepoch-space-constant.tar.gz
    shear_only_truth-multiepoch-space-variable.tar.gz
    shear_only_truth-real_galaxy-ground-constant.tar.gz
    shear_only_truth-real_galaxy-ground-variable.tar.gz
    shear_only_truth-real_galaxy-space-constant.tar.gz
    shear_only_truth-real_galaxy-space-variable.tar.gz
    shear_only_truth-variable_psf-ground-constant.tar.gz
    shear_only_truth-variable_psf-ground-variable.tar.gz
    shear_only_truth-variable_psf-space-constant.tar.gz
    shear_only_truth-variable_psf-space-variable.tar.gz

Each of these tar.gz files will itself unpack into a GREAT3 branch data-like
folder structure.

For constant shear branches, the ASCII text files `shear_params-*.txt` list the
g1 and g2 shear applied to each subfield.

For variable shear branches, the binary FITS table files `galaxy_catalog-*.fits`
contain the following hopefully self-explanatory columns:

    ID, g1, g2, g1_intrinsic, g2_intrinsic

with an entry for every galaxy.  The g1_intrinsic and g2_intrinsic come from
either the obvious and unique values for single Sersic component models, or
from adaptive moments estimates of the intrinsic ellipticity in the two
component models of the COSMOS the galaxy images (described in the GREAT3
Handbook).