The page <https://confluence.lsstcorp.org/display/LSWUG/Testing+the+Installation> is mostly quite clear. A few minor nits:
I find the "Demo Output" table and explanatory text confusing. I suspect that detected-sources.txt.expected and detected-sources_small.txt.expected are always written. In addition, one of detected-sources.txt or detected-sources_small.txt is written, depending on which script is run, and this should match the ".expected" version. In my case it does NOT match, which is disturbing, but I have no idea how serious a problem it is that they do not match.
afw is already setup by running the demo, so your instructions for visualizing the output do not need to say to do that.
Please provide or link to instructions for running an ipython notebook. I ran into a lot of trouble getting it going because I had forgotten how to do it and double-clicking the file caused all sorts of problems (which I won't go into, but I'd like to save other Mac users the pain). I think these instructions will work:
$ conda install ipython-notebook
$ ipython notebook
then the page that is displayed in your web browser to run StackDemo.ipynb
The notebook itself looks very nice to me. A scientist might be able to offer useful tips on enhancing the content, but to me it seems to provide a useful introduction to visualizing data.Here are a few minor nits:
"This visualization builds upon the <LSST Demo>; which assumes you have done the following to load the environment, retrieve the demo and run it:"
to something like:
"This visualizes data generated by <running the LSST Demo>"
If that links to the appropriate section then you can avoid duplicating how to run in this section. Even if you keep the duplication, I think you can lose the line:
- Download the StackDemo.ipynb notebook.
Typo: "Starb" -> Start
I had to remind myself how to run a cell (control-return on MacOS X), but the built-in help was helpful.
I see thin green vertical lines in the ds9 image from the second cell. It's hard to believe these are saturated pixels. It would be usful to explain what's going on.
maskPlaneColors is a cell, but there is no reason to run it, is there? This is slightly confusing, though running it is harmless.
bug in demoDisplay (in the last cell): I think it will crash due to `frameTitle` being undefined if `title` if not blank.