source: trunk/htdocs/pulsar_archive_guide.html @ 200

Last change on this file since 200 was 200, checked in by MatthewWhiting, 17 years ago

Further improvements to users guide.
File size: 6.5 KB
RevLine 
[189]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html>
[169]2<html>
3<head>
[193]4<link rel="stylesheet" type="text/css" href="styles/standard.css" />
[189]5<link rel="stylesheet" type="text/css" href="styles/query.css" />
6<link rel="stylesheet" type="text/css" href="styles/results.css" />
7<link rel="stylesheet" type="text/css" href="styles/atnf.css" />
8<meta http-equiv="Content-Type" content="text/html; charset=iso-8759-1" />
9<meta name="DC.Creator" lang="en" content="personalName=Teoh,Albert" />
10<meta name="ATNF.Maintainer" content="contactName=Webmaster,the" />
11<meta name="DC.Title.alt" lang="en" content="" />
12<meta name="DC.Subject" lang="en" content="pulsar" />
13<meta name="DC.Description" lang="en" content="Searches the data archives at the ATNF" />
14<meta name="DC.Date.created" scheme="ISO8601" content="2002-12-12" />
15<meta name="ATNF.Site" content="Marsfield" />
16<meta name="ATNF.AccessPermission" content="Public" />
17<meta name="ATNF.MetaVersion" content="1.0" />
[169]18</head>
[189]19<title>ATNF Pulsar Data Archive: Users Guide</title>
[169]20<body>
[189]21<?php include_once("header.html"); ?>
[193]22
[198]23<h1>ATNF Pulsar Data Archive: Users Guide</h1>
[193]24
[198]25<center><i>This page is still under construction!</i></center>
[193]26
[198]27<h2>Introduction</h2>
[193]28
[200]29<p>The ATNF Pulsar Data Archive exists to allow astronomers access to
[198]30observations of pulsars made with the Parkes radio telescope in the
[200]31last two decades.</p>
[193]32
[200]33<p>The data comes either from the Parkes Southern Pulsar Survey (the
[198]34"70cm Survey", Manchester et al. 1996, MN 279, 1235), or from
35observations of known pulsars with one of the Parkes instruments (WBC,
36DFB, CPSR2). We hope to make available data from the Multibeam Survey
[200]37at some point in the near future.</p>
[198]38
39<h2>Using the archive</h2>
40
[199]41<h3>Overview</h3>
42
[200]43<p>The Pulsar Data Archive provides a means for accessing observational
[199]44data. Queries are made according to position on the sky and can be
[200]45filtered by parameters such as data type and date.</p>
[199]46
[200]47<p>To download data, selections are made from the query results. These
[199]48are stored in a "cart" from which they can be downloaded as a tar
[200]49file. </p>
[199]50
[198]51<h3>How to make queries</h3>
52
[200]53<p>The data is queried primarily on positional information. The user
[198]54gives either a pulsar name or a RA/Dec position, plus a search
55radius. The pulsar name takes precedence over the RA/Dec position
56given, so to search by RA/Dec, make sure the pulsar name field is
[200]57empty.</p>
[198]58
59<h3>Query options</h3>
60
[200]61<p>The query can be refined according to a number of parameters:
[193]62<ul>
[198]63  <li> Time: A time range for the observations can be specified. The
64  default values for this are given by the extent of the archive
65  (ie. the default "from" date is the earliest observation, and the
66  default "to" date is the latest).
67  <li> Obs Mode: The query can be restricted to only survey data (just
68  the 70cm survey for the moment), or only timing data
69  (ie. observations of a particular pulsar). The default is both
70  types.
71  <li> Data Type: One of the different instruments (WBC, DFB, CPSR2,
72  FB_1BIT) can be selected. The default is all of them.
73  <li> Frequency range: Multiple frequency bands can be selected from
74  the list.
[200]75</ul></p>
[193]76
[200]77<p>The list of options on the left hand side shows the possible
[198]78parameters that can be returned with your query. Note that not all
[200]79fields will have values for all observations.</p>
[198]80
[200]81<p>The list can be ordered according to a limited range of these
[198]82parameters: distance (from the query position - the default), date of
[200]83observation, frequency, and filename.</p>
[198]84
[200]85<p>Finally, it is possible to search for calibration observations that
[198]86were taken within a given time period of the science observations. To
87do so, check the box under "DISPLAY OTHER DATA" and set the time limit
[200]88in which to search for Cals (the default is 30 minutes).</p>
[198]89
90<h3>Navigating around the archive</h3>
91
[200]92<p>The first page returned when you submit your query is the list of the
[198]93first (up to) 20 observations. Only 20 observations are displayed at a
94time. You can move through the list by clicking on the page numbers
[200]95above or below the table.</p>
[198]96
[200]97<p>Note that a limit of 1000 results is returned for the query -- if you
[198]98are getting more than this, perhaps you can afford to narrow your
[200]99search!</p>
[198]100
[200]101<p>In the top right, you will find information on the number of files and
[199]102total size of the cart, as well as a navigation icon. When the Query
103Results page is displayed, the icon shown is that of the cart.
104Alternatively, when the list of cart items is displayed, the icon
[200]105shown is that of the results table. Clicking on the icon takes you to
106the page depicted.</p>
[198]107
[200]108<center>
109<table cellpadding="0" cellspacing="0" border="0" width="200px" cellhalign="center">
110  <tbody>
111    <tr>
112      <td align="center">
113        <img alt="Cart icon" border="0" title="Cart icon" src="/images/cart_30px_white.png"></img>
114      </td>
115     <td align="center">
116       <img alt="Table icon" border="0" title="Table icon" src="/images/table_30px_white.png"></img>
117     </td>
118   </tr>
119   <tr>
120   <td align="center">
121     Cart Icon
122   </td>
123   <td align="center">
124     Table Icon
125   </td>
126  </tr>
127 </tbody>
128</table>
129</center>
130
[198]131<h3>Viewing profiles of pulsars</h3>
132
[200]133<p>For some types of data, it is possible to view a pre-scrunched pulse
[198]134profile. To do so, select the observations using the check boxes in
135the table, and select "View selected profiles" from the drop-down
136menu. This will display profile plots for all selected observations,
137unless they are unable to be pre-scrunched (for instance, survey
[200]138observations).</p>
[198]139
[200]140<p>To return to the results table, click the table icon at top right.</p>
[198]141
142<h3>Downloading data</h3>
143
[200]144<p>Since there can be a large number of query results, spread over many
[199]145pages, we have implemented the observation cart to act as a staging
146post for downloading data. Desired data is first saved to the cart
147using the drop-down menu, by selecting its check box. From the cart
148page, the drop-down menu offers the option of downloading either just
149the data or the data plus any cals that have been found. The data is
[200]150returned in a tar file that can be saved to a local disk.</p>
[198]151
152<h3>Caveats</h3>
153
[200]154<p>The archive is still in a developmental stage, albeit a fairly
[199]155complete one. The main area that needs some work is that many fields
156for a lot of the data files are not filled in. This will be rectified
157in the near future, but be aware that not all information will be
158present. Also note that not all fields <i>can</i> be filled in for
[200]159each data file: e.g. survey data cannot have a period defined.</p>
[198]160
161<h2>Acknowledgments</h2>
162
163
164
[193]165<?php include_once("footer.html"); ?>
[169]166</body>
167</html>
168
169
Note: See TracBrowser for help on using the repository browser.