Documentation prepared by Eric Thrane. Please direct inquiries to: eric.thrane@LIGO.ORG #################################################### 1.) What is this documentation? #################################################### This documentation is for the public data for "Directional limits on persistent gravitational waves using LIGO S5 science data." This paper, accepted for publication in PRL, is available on the LIGO DCC (#P1000031) and on the arxiv here: http://arxiv.org/abs/1109.1809 This documentation includes the data needed to make the plots in this paper. There are three figures in this paper, each with more than one plot: Fig1: six plots Fig2: two plots Fig3: three plots There are three matlab .mat files provided with this data release, one for each figure: fig1.mat fig2.mat fig3.mat We also provide data in asci text format. #################################################### 2.) What data is included in these mat files? #################################################### fig1.mat contains four variables: dec, ra, snr, ul. dec and ra are each 65160-element arrays that contain declination and right ascension respectively. snr and ul are structs containing the map values for the maps in Fig 1. They each have three elements: snr.a, snr.b, snr.c ul.a, ul.b, ul.c snr.a is the signal-to-noise ratio data for the map in the first column, snr.b is the signal-to-noise ratio data for the map in the second column, etc.. The ul struct contains analagous data for the upper limit maps (in the second row). The size of each one of these maps is 65160. The (ra,dec) value associated with each array is recorded by the ra, dec arrays. fig2.mat contains two variables: A, B. A.Cl_UL gives the left-hand upper limit values for Cl in Fig 2. The associated l-values go from 0 to 7. B.Cl_UL gives the right-hand upper limit values for Cl in Fig 2. The associated l-values go from 0 to 12. fig.3.mat contains four variables: gc, scox1, scox1_s4, sn Each variable is a struct, which contains sub-variables needed to plot the spectra in Fig. 3. The naming convention is gc = Galactic Center (middle plot) scox1 = Sco X-1 (left-hand plot red and blue) scox1_s4 = Sco X-1 S4 result (left-hand plot green and black) sn = SN1987A (right-hand plot) Each struct contains the following variables: ul, sig, f. ul is an array of upper limits and sig is an array of sigmas--both are a function of frequency. The associated frequency values are given in f. #################################################### 3.) What data is included in the asci text files? #################################################### There are twelve asci files, which contain information identical to the matlab files. There are six files for Fig 1--one for each panel: fig1a.dat fig1b.dat fig1c.dat fig1d.dat fig1e.dat fig1f.dat Each of these files has three columns, corresponding to R.A. DEC strain_power_upper_limit for panels a-b-c, and R.A. DEC SNR for panels d-e-f. There are two files for Fig2: fig2a.dat fig2b.dat Both of these files have two columns, corresponding to l Cl_upper_limit There are four files for Fig 3: (fig3a_s4.dat & fig3a_s5.dat) fig3b.dat fig3c.dat The first two files (a-b) provide data for the first panel. Files 3b and 3c are for the second and third panels respectively. Each of these figures has three columns: frequency sigma strain_upper_limit