spacewatch module¶

A script that downloads and manipulates spacewatch images.

This file exists as a standalone script that is run separate from the rest of the kpno project. The script downloads images from http://varuna.kpno.noao.edu/allsky.htm and archives them. Upon download the script extracts the timestamp of the image from the image, and then blacks out three of the four corners.

class spacewatch.DateHTMLParser[source]¶

Bases: html.parser.HTMLParser

Parser for data passed from image websites.

data¶

Extracted data from the image website HTML.

Type:	list

clear_data()[source]¶: Clear the data list of this parser instance.

handle_starttag(tag, attrs)[source]¶

Extract image links from the HTML start tag.

Parameters:	tag (str) – The start tag attrs (list) – The attributes attached to the corresponding tag.

spacewatch.block_text(directory, name)[source]¶

Blocks the text in the corners of the images.

Parameters:	directory (str) – Directory where the images are saved in the form yyyymmdd. name (str) – Name of the image.

Notes

The top right, lower right and lower left corner text will be blacked out. The top left corner, containing the date and time at which the image was taken will be left.

spacewatch.download_image(date)[source]¶

Download a single image.

This method is of a similar form to io_util.download_image, where date provides the date to save the image to.

Parameters:	date (str) – Date to download images for, in the form yyyymmdd.

Notes

Over the course of the run time of this method various status updates will be logged to date/download.log. The method will exit early and fail to download the image with a failure print out.

The Spacewatch images are located at http://varuna.kpno.noao.edu/allsky.htm

Spacewatch does not maintain an archive of the images, and the method downloads the most recent image and saves it with its timestamp into a folder determined by date.

spacewatch.download_url(link)[source]¶

Read the data at a url.

Parameters:	link (str) – The link to access and download data from.
Returns:	A requests.Response object containing data on success, or None on failure.
Return type:	requests.Response or None

spacewatch.make_video(directory)[source]¶

Make a time-lapse of images.

This method joins the images in directory into a timelapse image.

Parameters:	directory (str) – Directory where the images are saved in the form yyyymmdd.

Notes

The method uses ffmpeg to create the output video. The video will be saved as directory/vid.mp4. The framerate of the image will be 15 fps and the video is encoded using x264. The ffmpeg command used to generate the video is ffmpeg -framerate 15 -pattern_type glob -i `directory`/c_ut*.jpg -c:v libx264 -r 60 -pix_fmt yuv420p `directory`/vid.mp4

spacewatch.run_and_download()[source]¶

Runs the script and downloads the images.