Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Initializing the v2 COSEP, to get ready for the 2018 white papers #689

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Initializing the v2 COSEP, to get ready for the 2018 white papers #689

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
1941aef
Modified READMEs to refer to the 'COSEP'
drphilmarshall Sep 16, 2018
5f4573c
Update to Sept 2018
drphilmarshall Sep 16, 2018
608a858
Small advance while we get set up for v2
drphilmarshall Sep 16, 2018
ccd981e
Possible structure for capturing the 2018 white paper content
drphilmarshall Sep 17, 2018
66c9330
Copyright 2017
drphilmarshall Nov 19, 2018
4e2c6d5
Included MS comments in the tex file to help guide implementation
drphilmarshall Nov 19, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,3 +121,6 @@ sympy-plots-for-*.tex/
# Other stuff:
*_standalone.tex
attic
review
arxiv
MAF
86 changes: 48 additions & 38 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,29 +2,39 @@

Welcome to the online community thinking about LSST survey strategy ("cadence"), with quantifications via the Metric Analysis Framework.

We are writing a white paper on this topic, primarily composed of a set of individual science cases that are either very important, and somehow stress the observing strategy, and describing how we expect them to be sensitive to LSST observing strategy. MAF metric calculations are then being designed and implemented: these form the quantitative backbone of the document. You may have heard of the coming "Cadence Wars" - this white paper represents the "Cadence Diplomacy" that will allow us, as a community, to avoid, or at least manage, that conflict. We welcome contributions from all around the LSST Science community.
Together, we are developing the LSST Community Observing Strategy Evaluation Paper (COSEP), a living document that explores the effects that changes to the LSST survey strategy would have on the detailed performance of the anticipated science investigations.

<!--
* **[Read the current draft of the white paper](http://www.slac.stanford.edu/~digel/ObservingStrategy/whitepaper/LSST_Observing_Strategy_White_Paper.pdf)** (automatically generated PDF, updated every hour, in principle - [log file is here](http://www.slac.stanford.edu/~digel/ObservingStrategy/whitepaper/LSST_Observing_Strategy_White_Paper.log)) -->
You may have heard of the coming "Cadence Wars" - the COSEP represents the "Cadence Diplomacy" that will allow us, as a community, to avoid, or at least manage, that conflict.
As it explains in its introduction, the COSEP is "_the_ vehicle for the community to communicate to the LSST Project regarding the Wide-Fast-Deep and special survey observing strategies."
We welcome contributions from all around the LSST Science community.

* **[Read the current draft of the white paper](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/pdf/whitepaper/LSST_Observing_Strategy_White_Paper.pdf
The first version of the COSEP was posted to the arxiv in Summer 2017, and can be downloaded [here](https://arxiv.org/abs/1708.04058v1).
It was structured as a set of individual science cases that are each very important, and/or somehow stress the observing strategy; each of these sections described how we expect them to be sensitive to LSST observing strategy, and many included a MAF metric analysis (or the design of one). These science sections formed the quantitative backbone of the document, and followed an introductory chapter that laid out the suite of LSST Project-simulated cadences that existed at the time. The v1 COSEP's primary conclusions were:

1. The LSST Project should simulate, analyze and optimize the rolling cadence idea;
2. The LSST Project should execute a systematic effort to further improve the ultimate LSST survey strategy.

These conclusions informed the 2018 [Call for White Papers on LSST Cadence Optimization](https://docushare.lsst.org/docushare/dsweb/Get/Document-28382), which anticipates that the performance evaluation components of the white papers solicited will also be added to the COSEP, to provide a comprehensive reference point for survey strategy evaluation. We are currently setting up the COSEP to accept the 2018 white papers, on the way to producing version 2 in April 2019.


* **[Read the current draft of the COSEP](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/pdf/whitepaper/LSST_Observing_Strategy_White_Paper.pdf
)** (automatically generated PDF, rebuilt every time the `master` branch is updated)
[![Build Status](https://travis-ci.org/LSSTScienceCollaborations/ObservingStrategy.svg?branch=master)](https://travis-ci.org/LSSTScienceCollaborations/ObservingStrategy)

* **[Download v1.0 of the white paper](https://github.com/LSSTScienceCollaborations/ObservingStrategy/raw/master/whitepaper/releases/LSST_Observing_Strategy_White_Paper_v1.0.pdf)** This is the initial arxiv version, visible at https://arxiv.org/abs/1708.04058
* **[Download v1.0 of the COSEP](https://github.com/LSSTScienceCollaborations/ObservingStrategy/raw/master/whitepaper/releases/LSST_Observing_Strategy_White_Paper_v1.0.pdf)** This is the initial arxiv version, visible at https://arxiv.org/abs/1708.04058v1

* **[Join the conversation about this project at its issues list](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues)**

* **[Gauge the project's activity level](https://github.com/LSSTScienceCollaborations/ObservingStrategy/pulse/halfweekly)**
* **[Gauge the project's current activity level](https://github.com/LSSTScienceCollaborations/ObservingStrategy/pulse/halfweekly)**

* **[Suggest a new `OpSim` experiment](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/master/opsim/README.md)**
* **[Suggest a new `OpSim` experiment (a simulated cadence)](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/master/opsim/README.md)**

* **[Suggest some interesting commissioning observations](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/master/commissioning/README.md)**


#### Shortcuts

* Guidelines for how to get involved are [in the introduction of the white paper itself, in Section 1.4](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/master/whitepaper/preface.tex)
* Guidelines for how to get involved are [in the introduction of the COSEP itself, in Section 1.4](https://github.com/LSSTScienceCollaborations/ObservingStrategy/blob/master/whitepaper/preface.tex)
* For help getting started with git and GitHub, see this [handy guide](https://github.com/drphilmarshall/GettingStarted#top).
* Shortened URL for this repository (for passing around): [http://ls.st/o5k](http://ls.st/o5k)
* Community-contributed MAF metric code at the [`sims_maf_contrib` repository](https://github.com/LSST-nonproject/sims_maf_contrib/wiki)
Expand All @@ -43,43 +53,43 @@ End of old workshop links -->

## Contacts

This effort is being coordinated by [Zeljko Ivezic](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@ivezic) and [Beth Willman](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@bethwillman), while [Phil Marshall](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@drphilmarshall) is the white paper's editor-in-chief. Any of them can propagate your privately-communicated concerns into a redacted issue on this repository. Contributions are very welcome from all round the LSST science collaborations, and beyond. Perhaps we are missing a science case? Or an idea for how to perturb the observing strategy? We'd like to hear from you! Please send all your feedback to [this repo's issues](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues).
This effort is being coordinated by [Phil Marshall](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@drphilmarshall) (the v1 COSEP's editor-in-chief), with guidance from [Zeljko Ivezic](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@ivezic) and [Lynne Jones](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues/new?body=@rhiannonlynne). Any of them can propagate your privately-communicated concerns into a redacted issue on this repository. Contributions are very welcome from all round the LSST science collaborations, and beyond. Perhaps we are missing a science case? Or an idea for how to perturb the observing strategy? We'd like to hear from you! Please send all your feedback to [this repo's issues](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues).

All white paper content is Copyright 2015, 2016, 2017 The Authors. If you make use of the ideas and results in the white paper in your research, please cite it as **"(LSST Science Collaborations 2017)"**, and provide the URL of this repository: https://github.com/LSSTScienceCollaborations/ObservingStrategy. The BibTeX entry for the white paper is below. Thanks!
All COSEP content is Copyright 2017 The Authors. If you make use of the ideas and results in the COSEP in your research, please cite it as **"(LSST Science Collaborations 2017)"**, and provide the URL of this repository: https://github.com/LSSTScienceCollaborations/ObservingStrategy. The BibTeX entry for the v1 COSEP is below. Thanks!

```
@ARTICLE{LSSTObservingStrategyWhitePaper,
author = {{LSST Science Collaborations} and {Marshall}, P. and {Anguita}, T. and
{Bianco}, F.~B. and {Bellm}, E.~C. and {Brandt}, N. and {Clarkson}, W. and
{Connolly}, A. and {Gawiser}, E. and {Ivezic}, Z. and {Jones}, L. and
{Lochner}, M. and {Lund}, M.~B. and {Mahabal}, A. and {Nidever}, D. and
{Olsen}, K. and {Ridgway}, S. and {Rhodes}, J. and {Shemmer}, O. and
{Trilling}, D. and {Vivas}, K. and {Walkowicz}, L. and {Willman}, B. and
{Yoachim}, P. and {Anderson}, S. and {Antilogus}, P. and {Angus}, R. and
{Arcavi}, I. and {Awan}, H. and {Biswas}, R. and {Bell}, K.~J. and
{Bennett}, D. and {Britt}, C. and {Buzasi}, D. and {Casetti-Dinescu}, D.~I. and
{Chomiuk}, L. and {Claver}, C. and {Cook}, K. and {Davenport}, J. and
{Debattista}, V. and {Digel}, S. and {Doctor}, Z. and {Firth}, R.~E. and
{Foley}, R. and {Fong}, W.-f. and {Galbany}, L. and {Giampapa}, M. and
{Gizis}, J.~E. and {Graham}, M.~L. and {Grillmair}, C. and {Gris}, P. and
{Haiman}, Z. and {Hartigan}, P. and {Hawley}, S. and {Hlozek}, R. and
{Jha}, S.~W. and {Johns-Krull}, C. and {Kanbur}, S. and {Kalogera}, V. and
{Kashyap}, V. and {Kasliwal}, V. and {Kessler}, R. and {Kim}, A. and
{Kurczynski}, P. and {Lahav}, O. and {Liu}, M.~C. and {Malz}, A. and
{Margutti}, R. and {Matheson}, T. and {McEwen}, J.~D. and {McGehee}, P. and
{Meibom}, S. and {Meyers}, J. and {Monet}, D. and {Neilsen}, E. and
{Newman}, J. and {O'Dowd}, M. and {Peiris}, H.~V. and {Penny}, M.~T. and
{Peters}, C. and {Poleski}, R. and {Ponder}, K. and {Richards}, G. and
{Rho}, J. and {Rubin}, D. and {Schmidt}, S. and {Schuhmann}, R.~L. and
{Shporer}, A. and {Slater}, C. and {Smith}, N. and {Soares-Santos}, M. and
{Stassun}, K. and {Strader}, J. and {Strauss}, M. and {Street}, R. and
{Stubbs}, C. and {Sullivan}, M. and {Szkody}, P. and {Trimble}, V. and
{Tyson}, T. and {de Val-Borro}, M. and {Valenti}, S. and {Wagoner}, R. and
@ARTICLE{LSST-COSEP,
author = {{LSST Science Collaborations} and {Marshall}, P. and {Anguita}, T. and
{Bianco}, F.~B. and {Bellm}, E.~C. and {Brandt}, N. and {Clarkson}, W. and
{Connolly}, A. and {Gawiser}, E. and {Ivezic}, Z. and {Jones}, L. and
{Lochner}, M. and {Lund}, M.~B. and {Mahabal}, A. and {Nidever}, D. and
{Olsen}, K. and {Ridgway}, S. and {Rhodes}, J. and {Shemmer}, O. and
{Trilling}, D. and {Vivas}, K. and {Walkowicz}, L. and {Willman}, B. and
{Yoachim}, P. and {Anderson}, S. and {Antilogus}, P. and {Angus}, R. and
{Arcavi}, I. and {Awan}, H. and {Biswas}, R. and {Bell}, K.~J. and
{Bennett}, D. and {Britt}, C. and {Buzasi}, D. and {Casetti-Dinescu}, D.~I. and
{Chomiuk}, L. and {Claver}, C. and {Cook}, K. and {Davenport}, J. and
{Debattista}, V. and {Digel}, S. and {Doctor}, Z. and {Firth}, R.~E. and
{Foley}, R. and {Fong}, W.-f. and {Galbany}, L. and {Giampapa}, M. and
{Gizis}, J.~E. and {Graham}, M.~L. and {Grillmair}, C. and {Gris}, P. and
{Haiman}, Z. and {Hartigan}, P. and {Hawley}, S. and {Hlozek}, R. and
{Jha}, S.~W. and {Johns-Krull}, C. and {Kanbur}, S. and {Kalogera}, V. and
{Kashyap}, V. and {Kasliwal}, V. and {Kessler}, R. and {Kim}, A. and
{Kurczynski}, P. and {Lahav}, O. and {Liu}, M.~C. and {Malz}, A. and
{Margutti}, R. and {Matheson}, T. and {McEwen}, J.~D. and {McGehee}, P. and
{Meibom}, S. and {Meyers}, J. and {Monet}, D. and {Neilsen}, E. and
{Newman}, J. and {O'Dowd}, M. and {Peiris}, H.~V. and {Penny}, M.~T. and
{Peters}, C. and {Poleski}, R. and {Ponder}, K. and {Richards}, G. and
{Rho}, J. and {Rubin}, D. and {Schmidt}, S. and {Schuhmann}, R.~L. and
{Shporer}, A. and {Slater}, C. and {Smith}, N. and {Soares-Santos}, M. and
{Stassun}, K. and {Strader}, J. and {Strauss}, M. and {Street}, R. and
{Stubbs}, C. and {Sullivan}, M. and {Szkody}, P. and {Trimble}, V. and
{Tyson}, T. and {de Val-Borro}, M. and {Valenti}, S. and {Wagoner}, R. and
{Wood-Vasey}, W.~M. and {Zauderer}, B.~A.},
title = "{Science-Driven Optimization of the LSST Observing Strategy}",
journal = {ArXiv e-prints},
archivePrefix = "arXiv",
eprint = {1708.04058},
eprint = {1708.04058v1},
primaryClass = "astro-ph.IM",
keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - Earth and Planetary Astrophysics, Astrophysics - Astrophysics of Galaxies, Astrophysics - Solar and Stellar Astrophysics},
year = 2017,
Expand Down
70 changes: 47 additions & 23 deletions whitepaper/LSST_Observing_Strategy_White_Paper.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,51 +65,75 @@

% --------------------------------------------------------------------

% The v2 introduction should explain the structure of the paper,
% and describe the 2018 white paper process.

\include{introduction}

% --------------------------------------------------------------------

\include{cadexp2}

% --------------------------------------------------------------------
\part{Simulations}
\def\partname{sims}\label{part:\partname}

\include{solarsystem}
% Comment from Michael Strauss: I would suggest that we not simply copy
% Chapter 2 (cadexp2) of the previous COSEP into V2, as it will just
% confuse people who want a clean story about the status of the simulations.
% The earlier version had a lot of "aspirational" words about, e.g.,
% rolling cadence, that now is implementable with the feature-based scheduler,
% and I think we can tell a cleaner story without all the detours that were taken at the time V1 was written.

% --------------------------------------------------------------------
% There have been lots of changesin how cadences are simulated - let's
% summarize them here:
% \include{opsim-intro}
% This section shoudl include some history, to make the work that refers
% to minion_1016 etc make sense. That history can be distilled from
% cadexp2.tex.

\include{galaxy}
% Then, we can explain the new set of simulations that was provided with
% the 2018 WP call.
% \include{cadexp2018}

% --------------------------------------------------------------------

\include{variables}
\part{Science Cases and Performance Metrics}
\def\partname{science}\label{part:\partname}

% --------------------------------------------------------------------
% The science chapters will need updating and extending with the
% 2018 white paper content. We might consider re-organizing them
% into 4 themes.

\include{solarsystem}
\include{galaxy}
\include{variables}
\include{transients}

% --------------------------------------------------------------------

\include{magclouds}

% --------------------------------------------------------------------

\include{agn}

% --------------------------------------------------------------------

\include{cosmology}

% --------------------------------------------------------------------

\include{specialsurveys}
\include{wfirst}

% The tradeoffs chapter was a summary of the v1 analysis, and will need
% updating for v2:
\include{tradeoffs}

% --------------------------------------------------------------------

\include{wfirst}
\part{Proposed Observing Strategies}
\def\partname{proposals}\label{part:\partname}

% --------------------------------------------------------------------
% Chapters collecting together the various proposed cadences. This
% may not be the best way to do it; science theme could make more sense.
% \include{wfd}
% \include{ddf}
% \include{mini-surveys}
% \include{too}

% The SAC will provide a summary of their findings and conclusions,
% including a discussion of next steps (the SAC's recommendations):
% \include{sac-summary}
% Comment from Michael Strauss: This summary will also likely appear in
% a separate public document.

\include{tradeoffs}

% --------------------------------------------------------------------

Expand Down
2 changes: 1 addition & 1 deletion whitepaper/Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ LSST_Observing_Strategy_White_Paper.pdf: version LSST_Observing_Strategy_White_P
pdflatex LSST_Observing_Strategy_White_Paper.tex

version:
tcsh gen_version.csh --version 1.0
tcsh gen_version.csh --version 1.1

run: $(ARG)_standalone.tex LSST_Observing_Strategy_White_Paper.sty $(BIBFILES) $(TEXFILES)
pdflatex $(ARG)_standalone.tex
Expand Down
Loading