Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
164 lines (101 sloc) 7.89 KB

Getting started tutorial part 5: measuring sources

In this step of the :ref:`tutorial series <getting-started-tutorial>` you'll measure the coadditions you assembled in :doc:`part 4 <coaddition>` to build catalogs of stars and galaxies. This is the measurement strategy:

  1. :ref:`Detect sources in individual coadd patches <getting-started-tutorial-detect-coadds>`.
  2. :ref:`Merge those multi-band source detections into a single detection catalog <getting-started-tutorial-merge-coadd-detections>`.
  3. :ref:`Deblend and measure sources in the individual coadds using the unified detection catalog <getting-started-tutorial-measure-coadds>`.
  4. :ref:`Merge the multi-band catalogs of source measurements to identify the best positional measurements for each source <getting-started-tutorial-merge-coadds>`.
  5. :ref:`Re-measure the coadds in each band using fixed positions (forced photometry) <getting-started-tutorial-forced-coadds>`.


Instead of running multiple command-line tasks, like you'll do here, you could instead run the :command:`` command as an integrated multi-band source measurement pipeline.

Set up

Pick up your shell session where you left off in :doc:`part 4 <coaddition>`. That means your current working directory must contain the :file:`DATA` directory (the Butler repository).

The lsst_distrib package also needs to be set up in your shell environment. See :doc:`/install/setup` for details on doing this.

Detecting sources in coadded images

To start, you can detect sources in the coadded images to take advantage of their depth and high signal-to-noise ratio. Use the :command:`` command-line task to accomplish this: DATA --rerun coadd:coaddPhot \
    --id filter=HSC-R tract=0 patch=0,0^0,1^0,2^1,0^1,1^1,2^2,0^2,1^2,2

Notice that since this task operates on coadds, we need to select the coadds using the filter, tract, and patch data ID keys.

Also notice that you've created a new rerun for the photometry outputs, coaddPhot, that is chained to the coadd rerun.

Now repeat source detection in HSC-I-band patches: DATA --rerun coaddPhot \
    --id filter=HSC-I tract=0 patch=0,0^0,1^0,2^1,0^1,1^1,2^2,0^2,1^2,2

The :command:`` commands produce deepCoadd_det datasets in the Butler repository. Typically these datasets are only used as inputs for the :command:`` command, which you'll run next.

Merging multi-band detection catalogs

Next, use the :command:`` command to combine the individual HSC-R and HSC-I-band detection catalogs: DATA --rerun coaddPhot --id filter=HSC-R^HSC-I

This command created a deepCoadd_mergeDet dataset, which is a consistent table of sources across all filters.

Deblending and measuring source catalogs on coadds

Using the merged table of sources, the deblender retains all peaks and deblends any missing peaks (dropouts in that band) as PSFs. Repeating this procedure with the same master catalog across multiple coadds will generate a consistent set of child sources. Run the HSC-SDSS deblender separately in each band: DATA --rerun coaddPhot --id filter=HSC-R DATA --rerun coaddPhot --id filter=HSC-I

The :command:`deblendCoaddSources` command-line task produces deepCoadd_deblendedFlux datasets in the Butler data repository.

Now, use the merged detection catalog to measure sources in both the HSC-R and HSC-I coadd patches. You can accomplish this with :command:``: DATA --rerun coaddPhot --id filter=HSC-R

And repeat with the HSC-I-band coadd: DATA --rerun coaddPhot --id filter=HSC-I

The :command:`measureCoaddSources` command-line task produces deepCoadd_meas datasets in the Butler data repository. Because the same merged detection catalog is used for every filter, the HSC-R and HSC-I-band deepCoadd_meas tables have consistent rows. You'll see how to access these tables later.

Merging multi-band source catalogs from coadds

The previous step you created measurement catalogs for each patch in both the HSC-R and HSC-I bands. You'll get even more complete and consistent multi-band photometry by measuring the same source in multiple bands at a fixed position (the forced photometry method) rather than fitting the source's location individually for each band.

For forced photometry you want to use the best position measurements for each source, which could be from different filters depending on the source. We call the filter that best measures a source the reference filter. Go ahead and run the :command:`` command to create a table that identifies the reference filter for each source in the tables you created with the previous step: DATA --rerun coaddPhot --id filter=HSC-R^HSC-I

This command created a deepCoadd_ref dataset.

Running forced photometry on coadds

Now you have accurate positions for all detected sources in the coadds. Re-measure the coadds using these fixed source positions (the forced photometry method) to create the best possible photometry of sources in your coadds: DATA --rerun coaddPhot:coaddForcedPhot --id filter=HSC-R

Also run forced photometry on the HSC-I-band coadds: DATA --rerun coaddForcedPhot --id filter=HSC-I

The :command:`` command creates table datasets called deepCoadd_forced_src in the Butler repository. In a future tutorial you'll see how to work with these tables.


You can also try the :command:`` command to apply forced photometry to individual exposures, which may in principle yield better measurements. :command:`` doesn't currently deblend sources, though. Thus forced coadd photometry, as you've performed here, provides the best source photometry.

Wrap up

In this tutorial, you've created forced photometry catalogs of sources in coadded images. Here are some key takeaways:

:doc:`Continue this tutorial series in part 6 <multiband-analysis>` where you will analyze and plot the source catalogs that you've just measured.