About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: 11 August 2006

URL: http://cxc.harvard.edu/ciao3.4/survey/responses/ciaodocbest.html
Hardcopy (PDF): A4 | Letter

CIAO documentation features that users liked best

Back to the Survey
9 - threads

12 - ahelp and the threads.

13 - The threads are fantastic

23 - The threads are really spectacular.  

27 - again, what CIAO documentation?

28 - Threads and ahelp files are usually fine.

30 - the universality of ahelp

32 - The threads are incredibly useful.

38 - It has to be the threads and ahelp -- once they are correct
     of course, which many times does not seem to be the case

39 - Almost everything is there in the document.

40 - analysis threads

43 - ahelp files are good for details when you already know what to run
     (though the see also seems to list too much)

     multiple formats; sometimes I like to browse, sometimes I like to
     print and markup (so the pdf version is a nice feature)

47 - The threads are very useful for unfamiliar tasks.

49 - Ahelp pages on any ciao command.

51 - data products guide

58 - ahelp's ease of access, apropos capability, uniformity. 

59 - Threads!

60 - It is easy to obtain the documentation.

63 - The threads are really nice.

64 - I like the ease of getting to tool description quickly in ahelp.
     I wish there were about 4 times as many examples included in the ahelp,
     and more thorough descriptions of each parameter (including multiple examples of
     possible values).

67 - The Theads web page is very useful to get started in CIAO-based
     Chandra data analysis.

69 - The threads are very useful, and what I have looked at most often
     after the ahelp pages. I suspect I would have used the Analysis Guide
     a lot more had it existed when I first started working on chandra
     data.

70 - Threads.

75 - threads for common user tasks

80 - The manuals on the website, particularly the threads since they are very succinct

81 - threads are the most effective documentation component

82 - Threads

83 - threads

84 - examples

89 - Threads

90 - ahelp seems to be very complete.

99 - threads and ahelp, as mentioned above.

103 - ahelp is still the best way to get info.

105 - The presence of examples, the remainder to related problems and/or
      analysis aspects.

106 - The threads

108 - threads

113 - Threads

115 - none of them

119 - very well organized for on-line use
      I like the threads section

121 - ahelp

124 - Threads are OK, but they need more real-world examples.  They often
      do a simple example (which is good, gets you started), but then
      don't do any more realistic examples.  For example:  lightcurve
      filtering (1 chip).  Real world example:  I have an ACIS observation
      with 6 chips: how do I lightcurve filter on each chip separately
      and recombine the results?  

      Similarly for dealing with sky background: how do I construct
      sky background datasets for all the chips, merge everything back
      into a single event list, and have all the GTI's, etc., set up
      correctly?  I think there need to be many more examples like the
      step-by-step multi-chip exposure map thread. Lots more examples
      of how to do it with more than one of whatever it is.

125 - Threads

126 - The threads are quite good.

Back to the Survey
Hardcopy (PDF): A4 | Letter
Last modified: 11 August 2006


The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.