# ![HELP LOGO](https://avatars1.githubusercontent.com/u/7880370?s=75&v=4) HELP masterlist repository (DMU1)


This is a data product of the Herschel Extragalactic Legacy Project ([HELP](http://www.herschel.sussex.ac.uk)). 

The `masterlist` or `master catalogue` is the list of objects which define the HELP objects. It is built from a positional cross match of the multiwavelength catalogues in dmu0.

This repository contains all the HELP masterlists across the various fields. These catalogues are cross matched photometry catalogues constructed from the pristine catalogues contained in dmu0.

The final masterlists can be found on HeDaM:

- http://hedam.lam.fr/HELP/dataproducts/dmu1/

The column names in the master_catalogue tables are the same as in the final dmu32 catalogue and are described here:

- [../dmu32/columns.yml](../dmu32/columns.yml)

Each field folder contains: 

- Notebooks 1.x which describe the conversion of each pristine catalogue to HELP format.
- Notebook 2_Merging.ipynb which describes the merging of individual catalogues and addition of HELP derived data.
- Notebook 3_Checks_and_diagnostics.ipynb which shows some checks performed on the masterlists to confirm unit changes and other conversions have been performed correctly.
- Notebook 4_Selection_function.ipynb which describes the creation of depth maps to describe depth of the masterlist in a given band in a given HEALpix cell.


HELP Data Release 1
---------------------------------------

As new surveys and data releases continue to be released we define a masterlist across all HELP field called Data Release 1 (DR1). 

In some cases there may be newer data and a newer masterlist. You must take care in those cases when using subsequent HELP data products as we can't guarantee that the IDs and other data will properly match up.

The following table defines the DR1 masterlist in terms of the dated file that was used on a given field.

The file dr1_overview.fits gives an overview of the current DR1 definition. When a field has been run through to the final stage through all parts of help we will add the final used masterlist below. Occasionally, different partts fo the pipeline may have been conducted with a different masterlist file. In those case care was taken to ensure HELP ids do not change. It is however possible that new sources or photometry may have been added and that selection functions might be altered. In those cases one should take care to note which masterlist was used at any given stage.

Fits files can be found here: http://hedam.lam.fr/HELP/dataproducts/dmu1/

20180618 DR1 definition:


 HELP field            |  DR1 SUFFIX
-----------------------|------------------------------------------
AKARI-NEP              | 20180215
AKARI-SEP              | 20180221
Bootes                 | 20190201 
CDFS-SWIRE             | 20180613
COSMOS                 | 20190402
EGS                    | 20180501
ELAIS-N1               | 20171016
ELAIS-N2               | 20180218
ELAIS-S1               | 20180416
GAMA-09                | 20180601
GAMA-12                | 20180218
GAMA-15                | 20180213
HDF-N                  | 20180427
Herschel-Stripe-82     | 20180307
Lockman-SWIRE          | 20180219
NGP                    | 20180219
SA13                   | 20180501
SGP                    | 20180221
SPIRE-NEP              | 20180220
SSDF                   | 20180221
xFLS                   | 20180501
XMM-13hr               | 20180501
XMM-LSS                | 20190328
 
 These are the catalogues on which checks and diagnostics have been run, validations performed, xid+ fir fluxes calculated, photometric redshifts calculated, and CIGALE parameters fitted.
 
 -------------------------------------------------------------------------------

**Authors**: [Raphael Shirley](http://www.raphaelshirley.co.uk/), Yannick Rohelly, Peter Hurley, Ken Duncan, Kasia Malek, Estelle Pons, [Seb Oliver](http://www.sussex.ac.uk/profiles/91548)

 ![HELP LOGO](https://avatars1.githubusercontent.com/u/7880370?s=75&v=4)
 
For a full description of the database and how it is organised in to `dmu_products` please see the top level [readme](../readme.md).
 
The Herschel Extragalactic Legacy Project, ([HELP](http://herschel.sussex.ac.uk/)), is a [European Commission Research Executive Agency](https://ec.europa.eu/info/departments/research-executive-agency_en)
funded project under the SP1-Cooperation, Collaborative project, Small or medium-scale focused research project, FP7-SPACE-2013-1 scheme, Grant Agreement
Number 607254.

[Acknowledgements](http://herschel.sussex.ac.uk/acknowledgements)