Difference between revisions of "Instrument Paper Comment"

From CMB-S4 wiki
Jump to navigationJump to search
 
(75 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
You can also send comments to Aritoki Suzuki at asuzuki@berkeley.edu
 
You can also send comments to Aritoki Suzuki at asuzuki@berkeley.edu
  
When editing, please follow style suggested by Maria
+
=== LATEX style ===
 +
# Bunch of \newcommand (and similar) defined after \begin{document} in the cmbs4_instbook.tex, although it doesn't seem to cause any failures, it feels like many of those commands should live in the preamble. See for example the ADS abbreviations. It would be useful to clean up this file to improve readability. I think it generally makes it easier for people to contribute to the document.
  
* '''Style consistency (suggested by Maria)'''
+
=== General comment ===
** in the text use words for indicate numbers for example: from "1 or 2 bands" to "one or two bands". Another example: "three-axis mount" instead of "3-axis mount". But for expressions as 1000 TESes, use numbers not words.
+
# comments
** Preferring CMB-S4 instead of S4 (few times in the next S4 was used).
 
** Stage-II instead of Stage-2 or stage-2.
 
** Numbered items listed in the text: (i), (ii).
 
** ~ for space doesn't work. Use instead \, .
 
** Medium size space between number and unit of measurement: 15\,GHz instead of 15 GHz or 15GHz.
 
** Ranges of numbers, for example: (120--280)\,GHz instead of 120-280 GHz (since GHz refers to the entire range).
 
** Lowercase for indicating the name of materials: alumina instead of Alumina.
 
** Caption of figures/tables:\emph{ (Top) bla bla bla bla. (Left) bla bla bla}.
 
  
=== General comment / LATEX style etc===
+
=== Acronym Table: Bibliography ===
* Please add comment here
+
# comments
  
=== Executive summary ===
+
=== Introduction and Conclusion ===
* In the Executive Summary, I liked the Receiver Optics and Focal Plane Optical Coupling parts. They get the basics across "smoothly".
+
# comments
 
 
The Telescope Design and Focal Plane Sensors and Readout sections were a bit choppier -- with different levels of paragraphs and subsections. For example, the paragraph about computer simulations for FSLs might be too detailed for the Executive Summary.
 
 
 
In the receiver optics part of the Executive Summary, the first paragraph implies that larger sizes would be nice, but then each bullet point afterwards says that larger sizes are *needed*. It seems sort of contradictory.
 
 
 
*
 
 
 
=== Introduction ===
 
* Please add comment here
 
  
 
=== Telescope design ===
 
=== Telescope design ===
* Please add comment here
+
# Table 2-1: BICEP array, BICEP3, SPIDER info need to be added (Lorenzo: by 6/1/2017 morning)
  
 
=== Receiver optics ===
 
=== Receiver optics ===
* Please add comment here
+
# Improved Sections 3.5 and 3.7 intro? (Jeff)
  
 
=== Focal plane optical coupling ===
 
=== Focal plane optical coupling ===
* Need to define ARC
+
# capture CLASS technology (waiting for input from Karwan: by 6/1/2017 noon)
  
 
=== Focal plane sensor and readout ===
 
=== Focal plane sensor and readout ===
* Please add comment here
+
# comment

Latest revision as of 10:32, 1 June 2017

Please add comments in appropriate section: You can also send comments to Aritoki Suzuki at asuzuki@berkeley.edu

LATEX style

  1. Bunch of \newcommand (and similar) defined after \begin{document} in the cmbs4_instbook.tex, although it doesn't seem to cause any failures, it feels like many of those commands should live in the preamble. See for example the ADS abbreviations. It would be useful to clean up this file to improve readability. I think it generally makes it easier for people to contribute to the document.

General comment

  1. comments

Acronym Table: Bibliography

  1. comments

Introduction and Conclusion

  1. comments

Telescope design

  1. Table 2-1: BICEP array, BICEP3, SPIDER info need to be added (Lorenzo: by 6/1/2017 morning)

Receiver optics

  1. Improved Sections 3.5 and 3.7 intro? (Jeff)

Focal plane optical coupling

  1. capture CLASS technology (waiting for input from Karwan: by 6/1/2017 noon)

Focal plane sensor and readout

  1. comment