The GCN Reports

TABLE OF CONTENTS:

  1. INTRODUCTION
  2. MOTIVATION
  3. PRODUCT NAME
  4. CONTENT
  5. UPDATABLE
  6. MEDIA
  7. FIGURES and TBALES
  8. REFERENCES
  9. FORMAT STYLE
  10. TIMESCALE
  11. REPORTS ARE NOT REQUIRED
  12. SUBMITION PROCEDURE STEPS
  13. ANNOUNCMENT OF EACH NEW REPORT
  14. ENABLING RECEIVING REPORT ANNOUNCMENTS
  15. ARCHIVING
  16. EDITORIAL ACTIVITY

SUMMARY FOR THOSE WHO JUST NEED A QUICK REMINDER HOW TO SUBMIT:

1) Prepare your report.
2) Convert it to PDF format.
3) Mail your report as an attachment to "scott@milkyway.gsfc.nasa.gov".
(I will take care of posting it to the website and sending out the new-report announcement)


INTRODUCTION:

This is the announcement for a new product within GCN -- the "GCN Reports".
These are short (1-3 page), final descriptions of the observations and results
of a group's follow-up efforts on a specific burst.

MOTIVATION:

These Reports are being created to encourage people to publish their
fully-processed data; especially the many observers that don't have
enough observations by themselves to make their own paper. By having
this publication mechanism, then they can get their 1,2,3,N observations
out there for other people to use in their papers, and get officially recognized
for their contribution (via a reference citation).
A second motivation is that it will provide the Swift Team with a vehicle
to distribute their gamma/x/optical lightcurves in a more timely way.

PRODUCT NAME:

* There are 3 products in GCN: "Notices", "Circulars", and "Reports".
* Reports were added to the GCN Oct 2006.
* The citation for a report look like: "GCN Report 27.1"
(where 27 is the serial number and 1 is the version number).
This matches the citation style of Nature, ApJ, & MNRAS for the Circulars:
"GCN Circ. NNNN".

CONTENT:

The guidelines for the content of these Reports are:
* Observations, fully processed/corrected analyzed, all collected together
(just as if it were a formal publication -- this is intended to be
very much like a formal publication). Because the Circulars are
published in near real time, the data points may not always have the full
corrections and calibration applied -- the Reports solve that deficiency.
By having these fully-corrected data points, other authors can include
your data points in their calculations/models/publications.
* Reports should not be copies of your Circular. Reports should be issued
only if you have done significant improvement in the data reduction analysis.
* These "reports" are short -- of order 50-100 lines of text.
* Figures are encouraged. Tables of the data points in those figures
are encouraged (or just the table if a figure is not warranted).
* Total length is 2-3 pages.
* No theory. (theory papers should go to astro-ph)
* But there can be very brief discussions/interpretations/implications section.
* For data reduction/analysis, a section on this topic can be included
if something special was done -- beyond the standard method(s), eg handling
of pulse pile up; a near-by bright star; etc.
* One burst per one Report. Do not combine the observations from two or more bursts
into a single Report.

UPDATABLE:

* These Reports are updatable, ie revisions can be issued.
(This updating capability is really only for Swift submissions, but others might
make use of it as well.)
* Authors will be encouraged to include a "deltas" paragraph in each update.
Where "deltas" means what has changed from the previous version
to this version; eg. "Fig 2 has another 100 Ksec of observations".
* There will be a 'serial_number' and a 'version_number'. The author assigns
the version_number, and I/GCN assigns the serial_number (starting from 1).
* All versions will stay permanently accessible to the public (ie on the GCN website).
* While updated versions from all observers are allowed, it is envisioned
that the Swift Team is the dominate reason for allowing updates. This will
allow the Swift Team to publish an initial Report on a burst (to publish
the lightcurve quickly), and then as follow-up observations continue
on that burst, the lightcurves can be updated as the follow-up observations
increase (eg T+2 days, 4 days, 7 days, 14, etc, until no more follow-ups
are made by Swift).

MEDIA:

* Only PDF format are accepted.
* All the text, figures and tables are combined into a single PDF file.

FIGURES & TABLES:

* Figures are encouraged in these "Reports" -- a lightcurve is worth
a thousand words. (If you only have a handful of points, then a table
is sufficient.)
* Tables are also encouraged. The values displayed in a lightcurve plot
should be included in a table in the Report (with error bar values included).
(To reiterate, these Reports are to allow other people to use your data
in a citable form in their papers. They need the data points in text tabular form.)

REFERENCES:

Inside these Reports:
* References to GCN Circulars should be of the form
"J. Doe, et al., GCN Circ. 5523".
* References to journal articles, books, etc, should follow the standard
conventions and formats. They can be in-line or collected at the end
of the Report.

FORMAT STYLE:

* You can use any formatting style you wish for the text and figures.
* For the text part, 1 or 2 columns is acceptable.
* ApJ, Nature, MNRAS, etc are all acceptable styles. (There are convenient
LateX style files for these formats than can be used. And then when
the PostScript file is produced, conversion to PDF is a simple matter.)
Free-text is also acceptable.
* Figures and Tables should be numbered and have a caption.
* Figures should have labels for the x- & y-axes.
* At a bare minimum, there needs to be a Title, an Author list (with simple
institutional affiliations), text, figures, and tables.
Abstracts are discouraged -- these Reports are already short enough
that they do not need an abstract.

TIMESCALE:

* These are NOT immediate publications, but they should still be timely.
* Depending on your particular type of observation, the time-for-submission
should be in the few days to two weeks range.
* Swift will be a special case, because the community's need for gamma, xray, & optical
lightcurves is sooner than for other ground-based types of observations.
* In practice, there will be no cut-off time limit on the publication; if you
wait a year, it will be published too. However, if you wait that long,
I suspect nobody will ever make use of your observations.

REPORTS ARE NOT REQUIRED:

If a person/group submits a Circular (about their observations on a given burst),
they are definitely NOT required to later submit a Report. I do not want
to discourage people from making that initial Circular submission
on their onesie/twosie data points. Those timely initial observations are important
to rest of the follow-up community trying to develop their follow-up observing
plans. If you are only going to commit to one (Circulars or Reports), it is
much more desirable to submit the Circular than the Report (ie timeliness before
ultimate accuracy).

SUBMISSION PROCEDURE STEPS:

1) The author prepares the text and any figures/tables into a single PDF file.
2) Send that PDF file to scott@milkyway.gsfc.nasa.gov (as an email attachment).
(Do NOT send it to the Circulars address as this will likely be accepted
and therefore distributed to the community by the automated demon;
which will be somewhat embarrassing.)
The attached file should have a name of the form: GRBYYMMDD_report.pdf.
Maybe your name (or initials) should be included.
3) I will unpack it and apply a watermark (in tht top-left corner)
that has the SerialNumber, VersionNumber, and the arrival date-stamp.
Please do NOT insert this string yourself, as you may not get the latest serial number correct.
4) I will post it to the webpage: gcn.gsfc.nasa.gov/report_archive.html
(Very similar to the way the Circulars are posted on the web site.)
[Maybe later this will be automated with an upload-page on the GCN website.]
5) I will send out a short message to the Circulars list that this new Report
is available. A URL to the new Report will be included.
6) You click the URL in the Announcement email (or go to the GCN webpage)
to download the PDF file. [It is possible that these Reports
could be "pushed" to you like the Circulars are email pushed, but until
I hear a groundswell of desire for pushed Reports, they will be
only available by "pulling" them from the website.]

NEW REPORT AVAILABLE ANNOUNCEMENTS:

* The announcement email will look something like:
GCN_Report 27.1 has been posted:
http://gcn.gsfc.nasa.gov/reports/report_27_1.pdf
by A. Firstauthor, [et al.]
titled "Final analysis of Swift GRB 060929".

ARCHIVING

The Reports will be archived at:
Archive

ENABLING RECEIVING REPORT ANNOUNCEMENTS:

The Circulars list is used to contain the Report enable/disable status.
if you already have a Circulars entry, then send me an email
saying you want to be enabled to receive the Reports announcement emails as well;
to disable those announcements (if at some later time you no longer want
to receive them).
It is also possible to receive the Report announcements wthout receiving the Circulars.

EDITORIAL ACTIVITY:

* In general, there will be no editorial review of the content of each Report.
It will be posted as received to the website.
However, if there you submit a particularly egregious violation of the guidelines.
then the author may be asked to resubmit a revised copy of the Report.

MINOR CHANGE TO THE CIRCULARS:

To make the distinction between the Reports and the Circulars a little clearer,
I have changed the TITLE line in the Circulars from the current value:
TITLE: GCN GRB OBSERATION REPORT
to:
TITLE: GCN CIRCULAR
The "observation report" phrasing was choosen ~8 years ago. It was appropriate,
but given the creation of the new Reports, this phrasing should be discarded
in favor of the more common usage of Circular when referring to these things.


Return to GCN/TAN homepage.
This file was last modified on 07-Feb-13.