aaronroodman / lighthouse_shapes

documenting results of the lighthouse shape workshop

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

desc-0000-lighthouse_notes-lsst_shape_measurement

Problems and Solutions for LSST Shape Measurement

Lighthouse People

LSST weak lensing science has unprecedented requirements for the modelling of the LSST point spread function, the accurate measurement of galaxy shapes in the face of blending. In this document, we describe the results of a workshop on these issues held at Point Montara in February 2017. We discuss available solutions for the problems of PSF modelling and shape measurement, their remaining shortcomings. In addition, we lay out a strategy for handling multi-epoch image date in a data structure useful with present weak lensing image analysis codes and a framework for validation of PSF and shape measurement through image simulations.

Editing this Paper

Fork and/or clone the project repo, and then edit the primary file. The name of this file will vary according to its format, but it should be one of either main.rst (if it's a reStructuredText Note), main.md (if it's a Markdown Note), main.ipynb (if it's an IPython Notebook) or main.tex (if it's a latex Note or paper). Please use the figures folder for your images.

Building this Paper

GitHub is our primary distributor for LSST DESC Notes: once the Note has been merged into the project repo's master branch, it will be visible as a shared (but not published) paper. The presentation of Notes will be improved later, as the LSST DESC Publication System evolves.

You can compile latex papers locally with

make  [apj|apjl|prd|prl|mnras]

make with no arguments compiles the latex using the default_format stored in .metadata.json. Choosing tex causes the paper to be made using the texmf/styles/lsstdescnote.cls class, with commands defined in texmf/styles/lsstdesc_macros.sty. Don't edit these style files, as you may want to replace them with newer versions as they become available. Instead, use the macros.tex file to add your own newcommand's and def's.

At present, the Makefile is only used to compile latex. In future, we hope to enable compilation of jupyter notebooks, Markdown and reStructuredText format notes into PDF as well.

Updating the Styles and Templates

From time to time, the latex style files will be updated: to re-download the latest versions, do

make update

This will over-write your folder's copies - but that's OK, as they are not meant to be edited by you! The template files (main.* etc) are also likely to be updated; to get fresh copies of these files, do

make templates

However, since you will have edited at least one of the templates in your folder, make templates creates a special templates folder for you to refer to. Finally, to get new style or template files that are added to the start_paper project, you'll need to first get the latest Makefile, and then make update and/or make templates. The command to obtain the latest Makefile is

make new

This will add the latest Makefile to your templates folder. If you want to over-write your existing Makefile, you can do

make upgrade

Automatic PDF Sharing

If this project is in a public GitHub repo, you can use the .travis.yml file in this folder to cause travis-ci to compile your paper into a PDF in the base repo at GitHub every time you push a commit to the master branch. The paper should appear as:

https://github.com/danielgruen/lighthouse_shapes/blob/pdf/lighthouse_shapes.pdf

About

documenting results of the lighthouse shape workshop


Languages

Language:TeX 98.2%Language:Jupyter Notebook 1.1%Language:Makefile 0.7%