Skip to content

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

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

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 4 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 2015, 2016, 2017, 2018 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
55 changes: 32 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,60 @@

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

% 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}

% --------------------------------------------------------------------
% v2 could have two chapters, for the two suite of simulations we
% now have:

\include{solarsystem}
\include{cadexp2}
% \include{cadexp2018}

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

\include{galaxy}
\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}

\include{tradeoffs}
% The SAC will provide a summary of their findings and conclusions,
% including a list of new cadences to be simulated:
% \include{sac-summary}

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

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
17 changes: 10 additions & 7 deletions whitepaper/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,26 @@

[![Build Status](https://travis-ci.org/LSSTScienceCollaborations/ObservingStrategy.svg?branch=master)](https://travis-ci.org/LSSTScienceCollaborations/ObservingStrategy)

A community white paper about LSST observing strategy, with quantifications via the the Metric Analysis Framework.
the LSST Community Observing Strategy Evaluation Paper (COSEP) is 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,
with quantifications via the the Metric Analysis Framework.

* **[Read the current version of the paper here](http://www.slac.stanford.edu/~digel/ObservingStrategy/whitepaper/LSST_Observing_Strategy_White_Paper.pdf)** (automatically generated PDF, updated hourly - [log file is here](http://www.slac.stanford.edu/~digel/ObservingStrategy/whitepaper/LSST_Observing_Strategy_White_Paper.log))
* **[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)


## How to contribute

We welcome contributions from all members of the LSST project and science community!
The white paper contains guidelines for authors on how to get involved - including hyperlinks to useful resources.
The COSEP contains guidelines for authors on how to get involved - including hyperlinks to useful resources.

If you would like to propose changes or additions to the white paper, please:
If you would like to propose changes or additions to the COSEP, please:

* 1) First, read the [paper](http://www.slac.stanford.edu/~digel/ObservingStrategy/whitepaper/LSST_Observing_Strategy_White_Paper.pdf) and the [issues](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues) to see if your suggestion is already being discussed.

* 2) Then, to edit the paper, first [fork](https://help.github.com/articles/fork-a-repo/) this repository, clone it to your local machine, and edit the text. To compile the PDF, just hit `make` in the `whitepaper` folder.
* 2) Then, to edit the COSEP, first [fork](https://help.github.com/articles/fork-a-repo/) this repository, clone it to your local machine, and edit the text. To compile the PDF, just hit `make` in the `whitepaper` folder.

* 3) After you have committed and pushed your changes, you can submit a [pull request](https://help.github.com/articles/using-pull-requests/) to get your work accepted into the white paper by the editors. Thanks!
* 3) After you have committed and pushed your changes, you can submit a [pull request](https://help.github.com/articles/using-pull-requests/) to get your work accepted into the COSEP by the editors. Thanks!


If the document does not compile, and you cannot fix the problem, please submit the error message and your preliminary diagnosis as an [issue](https://github.com/LSSTScienceCollaborations/ObservingStrategy/issues).
Expand All @@ -30,4 +33,4 @@ Section Leads: you will need to make sure that your section is correctly read in

## License, credit etc

This paper contains research in progress. All content is Copyright 2015, 2016, 2017 The LSST Science Collaborations. If you would like to cite it, please do so as "(LSST Science Collaborations, in preparation)" and provide a footnote containing the URL of this repository: https://github.com/LSSTScienceCollaborations/ObservingStrategy. The LaTeX and python code used here is distributed for you to use at your own risk under the MIT License. We are grateful to the developers of [yahapj.bst](https://github.com/AASJournals/yahapj) for enabling our hyper-linked reference list.
This paper contains research in progress. All content is Copyright 2015, 2016, 2017, 2018 The LSST Science Collaborations. If you would like to cite it, please do so as "(LSST Science Collaborations, in preparation)" and provide a footnote containing the URL of this repository: https://github.com/LSSTScienceCollaborations/ObservingStrategy. The LaTeX and python code used here is distributed for you to use at your own risk under the MIT License. We are grateful to the developers of [yahapj.bst](https://github.com/AASJournals/yahapj) for enabling our hyper-linked reference list.
Loading