Obtaining a Set of Images for the KBLR Project


The image check out and check in procedures are described in a video for your viewing pleasure. If you would rather read the instructions, they are available below.

We will provide flattened FITS images for the KBLR project. The images, from the LONEOS project, will have reasonably accurate WCS information and they will have the proper set of FITS keywords so they may be used by software packages that require the SBIG FITS convention.

In general terms, each user will check out a set of four frames and then download them. After the user examines the images and builds an MPC compliant report, the user may submit the report back to Lowell Observatory and take the images out of circulation. The user may also check the images back in without submitting an MPC report.

Step 1. Go to the check out web site, select a set of frames, and download them.

Procedure Sub-steps Expected Result
From your web browser, go to the frame check out page. The check out page appears in your browser.
You must login using your LARI User ID and Password. Once you successfully login, you should be on a web page that provides a list of frames available for analysis.
Select the radio button beside the set of frames you wish to analyze. Then depress the "Check_Out" button. You may select only one set of frames. The next page can take a while to display. It is verifying that your requested files are available. Eventually it lists each of the four frames you requested.
Click on the first of the four image names. The results of this step are browser and browser setup dependent. On my browser, a download dialog box appears and I ask the browser to "Save file". The file is copied to my download area.
Repeat the preceding step for each of the three remaining images. Now all four of the images are in your download area.
At this point, you are finished and all the bookkeeping is finished. But just to kick a sleeping dog, I like to go back to the previous page and depress the browser's "Reload" button. The list of available frames now shows that the frameset you just checked out is no longer available for check out. However, it should be listed as available for check in.

Step 2. Move your images from your browser's "Downloads" directory to your "Image" directory. This a Windows operation and we will assume that you know Windows well enough that detailed instructions are not required.

Procedure Sub-steps Expected Result
We suggest that you create a sub-directory for images. For example, "Images". You should probably put this in your home directory. That is, "C:\Users\FredFlintstone\Images".
We suggest you create a sub-directory under the appropriate configuration directory that is named for the date of the images. For example, "C:\Users\FredFlintstone\Images\2007-04-16".
We suggest you make a sub-directory under the date sub-directory to indicate the LONEOS region which is appropriate for your images, i.e, "C:\Users\FredFlintstone\Images\2007-04-16/3029". For LONEOS, we divided the sky into about 5000 numbered regions, each the size of the LONEOS telescope field of view. All the images have the region number recorded in the FITS header and as part of the image file name. See the next step for details.
Use Windows Explorer to copy the data images from the "Downloads" directory into the appropriate region sub-directory. Note that the format of the image file name is yyyynnddhhmmssrrrrq.fits where yyyy is the year, nn is the month, dd is the day, hh is the hour, mm is the minute, ss is the second, rrrr is the region number, q is a quartile mark and ".fits" is the suffix. That is, you can find the date, time and region number in the file name so you will not have to look in the FITS header.

Step 3. When you are finished processing a set of images you can check them back in or you may check them in and submit an MPC report. If you simply check them back in, your image set will be available to others for analysis. If you submit an MPC report, the system will take the images out of circulation and nobody else will be able to work on them.

Procedure Sub-steps Expected Result
OPTION 1: This step assumes you are already at the image checkout site. When you first access this site, the software will present your currently checked out images at the bottom. In order to check them in, select the radio button to the right of the listed set of images. Then depress the Check_In button. The browser will display a "Success" page indicating you have successfully checked in a set of images.
OPTION 2: Again, this step assumes you are already at the image checkout site and you see the image set you have checked out at the bottom of the page. If you want to check the images back in AND submit an MPC report, just put the file name of the MPC report in the field beside the "Check_In" button. Then depress the "Check_In" button. The browser will display a "Success" page indicating you have successfully checked in a set of images, the MPC report has been uploaded and the images have been taken out of circulation.
In both cases above, you can check the status of the image database by depressing the "back" button on your browser and then depressing the "Refresh" button. If you simply checked in an image set, you will see it listed as available for check out. You will not see it at the bottom of the page listed as availabe for check in. If you submitted an MPC report, you will not find the set of images available for either check out or check in. They are considered "finished" and are essentially taken out of circulation.

One further note. LONEOS images were originally 4k by 4k pixels but, to speed the CCD read time, we took advantage of four CCD read channels that could work in parallel with one another. Each channel would read a 1k by 4k region of the CCD. The downside of this operation is that each channel had different characteristics so each of the sections had to be flattened separately. Ultimately, this meant that we created four image files (called quartiles) for each picture we took. The "q" quartile mark referenced in the last step above refers to one of the four files (quartiles) in an image: far east -> d, east -> e, west -> w, far west -> x.