Merge pull request #43 from lsst/tickets/SP-1939

SP-1939: Add information on cell-based coadds plus some typoc

Author: leannep

.gitignore

@@ -176,6 +176,7 @@ TSWLatexianTemp*
 # WinEdt
 *.bak
 *.sav
+.idea/
 
 # Texpad
 .texpadtmp

Dockerfile

@@ -0,0 +1,24 @@
+FROM  lsstsqre/lsst-texmf:latest
+
+# Upgrade pip to latest version
+RUN python -m pip install --no-cache-dir --upgrade pip && \
+    python -m pip --version
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements.txt
+COPY requirements.txt* ./
+
+# Install Python dependencies if requirements.txt exists
+RUN if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+
+# Copy Python and LaTeX source files
+COPY . .
+
+# Make the build script executable
+RUN chmod +x /app/build.sh
+
+# Command to run make clean and make when container starts
+#CMD ["sh", "-c", "make clean && make"]
+CMD ["./build.sh"]

README.rst

@@ -48,7 +48,8 @@ Docker
 
 Compile this document through an lsst-texmf Docker image to avoid installing LaTeX and lsst-texmf on your own computer::
 
-    docker run --rm -v `pwd`:/build -w /build lsstsqre/lsst-texmf:latest sh -c 'make clean; make'
+    docker build --platform linux/amd64 -t rtn-011-env .
+    docker run --rm -v "$(pwd)":/app rtn-011-env
 
 Or run the included script::
 

RTN-011.tex

@@ -143,7 +143,7 @@
 
 % Optional set citation information
 \setDocCitationInformation{
-Leanne P. Guy, Keith Bechtol, Eric Bellm, Bob Blum, Melissa L. Graham, {\v Z}eljko Ivezi\'{c}, Robert H. Lupton, Phil Marshall, Colin T. Slater, Michael Strauss. (2023). Rubin Observatory Plans for an Early Science Program (5.1). Zenodo \url{https://doi.org/10.5281/zenodo.5683848}.
+Leanne P. Guy, et al. Rubin Observatory Plans for an Early Science Program. Zenodo \url{https://doi.org/10.5281/zenodo.5683848}.
 }
 
 \graphicspath{{./}{figures/}}
@@ -153,12 +153,6 @@
 
 % Create the title page.
 \maketitle
-% Frequently for a technote we do not want a title page  uncomment this to remove the title page and changelog.
-% use \mkshorttitle to remove the extra pages
-
-% Leanne
-%\input{summary}
-%\clearpage
 
 % ADD CONTENT HERE
 \input{intro}

access.tex

@@ -10,7 +10,7 @@ \subsection{Data Access Centers}
 A number of Rubin Independent Data Access Centers (IDAC) are also under construction to provide additional user computing resources to LSST users around the globe (\citeds{RTN-003}).
 
 \subsection{Rubin Science Platform}
-
+\label{ssec:rsp}
 The Rubin Science Platform (RSP), described in \citeds{LSE-319}, is a set of integrated web-based applications, services, and tools that provides access to the Rubin data products and enables next-to-the-data analysis. 
 The RSP comprises three different ``Aspects'': a \emph{Portal} Aspect designed to provide an environment for data discovery, query, filtering, and visualization, a \emph{Notebook} Aspect to enable next-to-the-data analysis, and an \emph{API} Aspect for programmatic access to the Rubin data products via Virtual Observatory (VO) interfaces.
 The Portal and Notebook Aspects of the RSP make use of the same APIs as the API Aspect to internally access the LSST datasets.
@@ -35,7 +35,7 @@ \subsection{Rubin Science Platform}
 \item IVOA-compatible SIA image service;
 \item Qserv query temporary uploads;
 \item User query history capabilities;
-\item Context-aware documentation, e.g pop-ups in the portal, documentation in-context such as  ``click on the column name and go to the page that explains it in detail;''
+\item Context-aware documentation, e.g. pop-ups in the portal, documentation in-context such as  ``click on the column name and go to the page that explains it in detail;''
 \item Some Portal-Notebook integration features such as  seeding a notebook with a query that was executed in the Portal. 
 \end{itemize}
 
@@ -55,10 +55,11 @@ \subsection{Rubin Science Platform}
 RSP functionality that is under consideration for post-DR1:
 \begin{itemize}
 \item Access to GPUs;
-\item Bringing individual resources to the RSP, e.g. additional compute paid for by indoviduals. 
+\item Bringing individual resources to the RSP, e.g. additional compute paid for by individuals.
 \end{itemize} 
 
-\subsection{Community Brokers }
+\subsection{Community Brokers}
+\label{ssec:brokers}
 Alerts are fully world-public and will be accessible via one or more of the nine Rubin-endorsed Community Brokers\footnote{See \url{https://www.lsst.org/scientists/alert-brokers}}.
 During the commissioning period, Rubin will work with the Community Brokers to integrate them \citedsp{rtn-010}.
 Community access to early alerts will depend on the readiness of the Community Brokers. 

alertproduction.tex

@@ -14,9 +14,9 @@ \section{Alert Production in Commissioning and Early Operations}
 Both Alert Production and Solar System Processing depend on the existence of template images.
 During steady-state operations, these templates will be constructed during the annual Data Releases and will be built from the best available subset of images taken.
 To enable alert production to proceed during commissioning and early operations, it is necessary build templates incrementally as data become available, as recommended by the study described in \citeds{DMTN-107}.
-Because we have a smaller set of input images to choose from and uncertain knowledge about future observations, incremental template generation necessarily must balance the trade off of earlier template availability against template quality and spatial completeness.
+Because we have a smaller set of input images to choose from and uncertain knowledge about future observations, incremental template generation necessarily must balance the trade-off of earlier template availability against template quality and spatial completeness.
 Validation will be required to determine when to build incremental templates to maximize the net throughput of Early Science.
-Nevertheless our goal is to enable Alert Generation to begin over at least a subset of the survey area as soon as the data are scientifically useful.
+Nevertheless, our goal is to enable Alert Generation to begin over at least a subset of the survey area as soon as the data are scientifically useful.
 
 Scientifically it is important that once a template is constructed for a given region of sky, it is used exclusively until it can be updated in the next Data Release.
 Repeated changes to the template make it extremely difficult to construct usable lightcurves for objects from individual difference image sources: transient objects such as supernovae will be contaminated by changing flux levels from the evolving template, and variable objects such as variable stars and AGN will require repeated corrections for different template flux levels as well.

build.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python
+
+import yaml
+
+# Sample data for the table
+data = [
+    ["Name", "Age", "Occupation"],
+    ["Alice", 30, "Engineer"],
+    ["Bob", 25, "Designer"],
+    ["Charlie", 35, "Teacher"]
+]
+
+# Function to generate LaTeX table code
+def generate_latex_table(data):
+    # Start the table
+    latex_code = "\\begin{tabular}{|c|c|c|}\n\\hline\n"
+
+    # Add headers and data rows
+    for row in data:
+        latex_code += " & ".join(str(cell) for cell in row) + " \\\\ \n\\hline\n"
+
+    # End the table
+    latex_code += "\\end{tabular}"
+
+    return latex_code
+
+# Generate the LaTeX code for the table
+latex_table = generate_latex_table(data)
+
+# Output the LaTeX table code
+f = open("tables/test-python.tex", "a")
+f.write(latex_table)
+f.close()

build.sh

@@ -1,2 +1,22 @@
 #!/usr/bin/env bash
-docker run --rm -v `pwd`:/build -w /build lsstsqre/lsst-texmf:latest sh -c 'make clean; make'
+
+echo "Building latex tables..."
+python3 build.py
+
+if [ $? -eq 0 ]; then
+    echo "Tables built executed successfully!"
+else
+    echo "Tables bui;d failed!"
+    exit 1
+fi
+
+# Step 2: Run Makefile
+echo "Running Makefile..."
+make
+
+if [ $? -eq 0 ]; then
+    echo "Makefile executed successfully!"
+else
+    echo "Makefile execution failed!"
+    exit 1
+fi

commissioning.tex

@@ -7,7 +7,7 @@ \subsection{Commissioning Plan and Schedule}
 Figure~\ref{fig:commissioning-es-schedule} shows the detailed schedule of commissioning and early science activities relative to System First Light, as of \currentdate.
 \begin{figure}[htb]
 \centering
-\includegraphics[width=0.98\linewidth]{figures/rubinobs_on-sky_commissioning_and_early_science.pdf}
+\includegraphics[width=0.98\linewidth]{figures/rubinobs_on-sky_commissioning_and_early_science}
 \caption{Detailed schedule of commissioning  and early science activities relative to System First Light, as of \currentdate.}
 \label{fig:commissioning-es-schedule}
 \vspace{0.1cm}
@@ -26,9 +26,12 @@ \subsection{Commissioning Plan and Schedule}
 The On-Sky Engineering phase will be carried out with both ComCam and LSSTCam.
 Both the System Optimization and Science Validation (SV) phases will be carried out with LSSTCam. 
 The System Optimization phase will collect a set of observations designed to help optimize the system prior to starting the Science Validation phase.
-During the Science Validation phase, a series of SV Surveys designed to support scientific analyses that validate the system's performance and allow Rubin to demonstrate operations readiness will be carried out. See Section 6 of \citeds{SITCOMTN-005} for the baseline design of the SV surveys.
-The System Optimization and SV phases contain a number of planned key components, including an LSST wide-fast-deep (WFD) 1-2 year equivalent depth ``pilot'' survey.
-In all phases, field selection will be carried out by the commissioning team, taking into account a wide variety of constraints as well as a ``menu'' of science opportunities to which the LSST Science Community has contributed.
+During the Science Validation phase, a series of SV Surveys designed to support scientific analyses that validate the system's performance and allow Rubin to demonstrate operational readiness will be carried out.
+The System Optimization and SV phases contain a number of planned key components, which currently include an LSST wide-fast-deep (WFD) 1--2 year equivalent depth ``pilot'' survey and a 
+10+~year ``ugrizy'' depth test in three fields covering 100~sq. deg.
+In all phases, field selection will be carried out by the commissioning team, taking into account a wide variety of constraints as well as a ``menu'' of science opportunities to which the Rubin Science Community has contributed.
+See Section 6 of \citeds{SITCOMTN-005} for the baseline design of the SV surveys.
+All plans for commissioning observations are subject to change based on system readiness up until the moment of execution. 
 
 The System Optimization and SV survey phases are expected to last about 8 weeks each.
 The project schedule will continue to evolve as the remaining subcomponents are delivered. 
@@ -51,10 +54,10 @@ \subsection{Commissioning Milestones}
 LSSTCam First Photon occurs following the successful completion of system integration. 
 There are no quality criteria applied to achieving  neither the ComCam nor LSSTCam First Photon milestones. 
 System First Light  marks the end of the  on-sky engineering phase and the start of the System Optimization and Science Validation phases of commissioning.
-The period between ComCam First Photon and System First Light will focus on fine tuning the system including optical alignment and improving the image quality and collecting calibration data.
+The period between ComCam First Photon and System First Light will focus on fine-tuning the system including optical alignment and improving the image quality and collecting calibration data.
 For a detailed description of all the commissioning milestones and the most current dates, see \citeds{dmtn-232}.
 
-\subsection{ComCam Commissioning }
+\subsection{ComCam Commissioning}
 \label{ssec:commissioning-comcam}
 
 ComCam is Rubin's engineering camera that is used for testing and validating the observatory's systems and processes prior to installation of the LSST Camera.
@@ -69,7 +72,7 @@ \subsection{ComCam Commissioning }
 A full report on the ComCam on-sky commissioning campaign is available at \citeds{sitcomtn-149}.
 
 
-\subsection{LSSTCam Commissioning }
+\subsection{LSSTCam Commissioning}
 \label{ssec:commissioning-lsstcam}
 
 As of \currentdate, LSSTCam is being installed on the Simonyi Survey Telescope and on-sky observing is expected to begin in April 2025.

communication.tex

@@ -1,5 +1,5 @@
 \section{Community}
-
+\label{sec:community}
 Rubin Observatory will work closely with the Survey Cadence Optimization Committee (SCOC) and Community on the detailed design of the Early Science Program. 
 
 \subsection{Survey Cadence Optimization Committee}
@@ -10,13 +10,13 @@ \subsection{Survey Cadence Optimization Committee}
 Recommendations will take into account the plans for commissioning and the realized performance of the telescope and software, and should align as closely as possible with those of the main survey and ultimate long-term science goals. 
 Optimizing the LSST Year 1 observing schedule for early science may mean that the time sampling looks somewhat different to that in subsequent years. 
 
-The SCOC has published its Phase 1 and 2 survey cadence recommendations in \citeds{PSTN-053} and \citeds{PSTN-055}. 
+The SCOC has published its Phase 1 and 2 survey cadence recommendations in \citeds{PSTN-053} and \citeds{PSTN-055}.
 Work on recommendations for Early Science observations will begin in 2023.
 The SCOC will solicit input from the community on the specific observing strategy in year 1 to optimize early science. 
-Several science collaborations have already been pro-active in providing input,  both the community forum and as research notes (\citep{2020arXiv201005926L}, \citep{Hambleton_2020}, \citep{Street_2020}).
+Several science collaborations have already been proactive in providing input,  both the community forum and as research notes (\citep{2020arXiv201005926L},~\citep{Hambleton_2020},~\citep{Street_2020}).
 
 
 \subsection{Community Forum}
-
+\label{ssec:forum}
 The Rubin Observatory Community Platform has a dedicated category for Early Science\footnote{See \url{https://community.lsst.org/t/about-the-early-science-category/5775}}, where community members are encouraged to open discussions on the topic of early science. 
 Community feedback on the Early Science data products is welcomed and will help the Rubin to improve its data products and services.