← Martz-Kohl Observatory

Martz-Kohl Observatory

Dashboard Guide

What it shows, where the data comes from, and how to read it

Open the dashboard →Download the PDF →

Created by Andy Felong  ·  andy@martzobservatory.org

The basics

What is the dashboard?

The dashboard is an always-on information screen for the observatory, in the spirit of a ham-radio HamClock: the time, the sky tonight, space weather, the weather at the dome, and what's coming up.

It runs as a web page at martzobservatory.org/mko-dashboard and is designed for a 1920 × 1080 display (such as a Raspberry Pi in kiosk mode), but works in any browser. A Night Mode button turns everything red-on-black to protect dark-adapted eyes.

Ten panels

Three columns: the clock, tonight's targets and satellites on the left; events, the AllSky camera, the Sun and the Moon in the middle; weather, radar and the clear-sky forecast on the right.

Fresh and honest

Every panel shows how old its data is. If something goes stale, that panel's header turns orange; if the whole system stops, a warning appears where the date is.

Look, don't touch

The dashboard only reads and displays. It never sends commands to the telescope, dome or cameras, and visitors' browsers never contact NASA, NOAA or the other sources directly.

How the data reaches the screen

1 · Outside sourcesNOAA, NASA, CelesTrak, cleardarksky.com, Helioviewer, Night Sky Network, plus MKO's own sensor and cameras
2 · Small scriptsOn the web server, run by a timer every 1 to 10 minutes. They fetch, check and calculate (sky positions are worked out here)
3 · One data filedashboard.json, plus saved copies of the pictures, so visitors never hit the original sources
4 · The pageYour browser re-reads the data file every 30 seconds and redraws each panel

The screen

Ten panels, numbered

This is the live dashboard (day view). Click a panel to jump to its description; the numbers run by column, left to right.

A capture of the live dashboard at 1920 × 1080.

The panels

What each one shows

1

Identity & Clocks

Who and where we are, and what time it is.

What it shows

  • MKO logo, street address, town, and the site's latitude, longitude and elevation (634.6 m / 2082 ft).
  • Local time with seconds, UTC, LST (local sidereal time: the sky's own clock, the right ascension crossing the meridian now) and JD (Julian Date).
  • The date, and the Night Mode button.

Where the data comes from

  • Calculated in your browser from its own clock; the site constants come from the project's config file. Nothing is fetched.
  • If the data behind the page stops updating, or the server can't be reached, a warning replaces the date line.

How often

Every second.

2

Up Tonight

What to point at tonight.

What it shows

  • Planets (Mercury to Neptune): Rise and Set; Dark = height an hour after full darkness begins (Now = height right now, once it is dark); Peak = the highest it gets tonight; Mag = brightness. A dash means below the horizon. A bright row means the planet is viewable tonight (at least 10° up at some time from now until sunrise, twilight counts as night); a dim row is not. Hover a row for the viewing window.
  • Best deep-sky objects (DSOs), planned for imaging: the six easiest objects (Easiest or Easy in the /dso catalog) that spend the most hours above 30° during tonight's dark hours, or from now on once it is dark. The caption gives the dark hours. Columns: ID (catalog number: M = Messier, C = Caldwell), Con (constellation), Object (name), Above 30° (first and last time it is that high) and Hours (how long). An object next to a listed one (inside 2°, such as M32 beside M31) is skipped.

Where the data comes from

  • Planet and DSO positions and times: calculated on the server with Skyfield and NASA/JPL's DE421 ephemeris.
  • DSOs: MKO's own /dso catalog (martzobservatory.org/dso), copied weekly, with coordinates from the OpenNGC database (credited in the panel header, CC BY-SA 4.0).

How often

Planets and DSOs recalculated every minute; the catalog is refreshed weekly.

3

Satellite Passes

Bright satellites you can see tonight.

What it shows

  • ISS, Tiangong, Hubble, BlueWalker 3 and the BlueBird phone satellites: start time, duration, Peak (the highest point of the pass), direction (where it appears to where it disappears) and brightness.
  • A yellow line counts down to the next ISS pass. A pass is listed when the satellite is above 10°, in sunlight, and the Sun is at least 6° below the horizon (peak at least 20°, except Hubble).

Where the data comes from

  • Orbits from CelesTrak (NORAD data), refreshed every 12 hours; passes calculated on the server with Skyfield.

How often

Passes recalculated every 5 minutes.

4

Upcoming Events

What's coming up at the observatory.

What it shows

  • A standing line for Open Observatory Night (every Wednesday 7:30 PM, next date), then the next lectures and meetings, and the next New Moon.

Where the data comes from

  • MKO's NASA Night Sky Network calendar (club 333), plus a small file of MKO corrections for cancelled or changed events. New Moon is calculated with Skyfield.

How often

Checked every 10 minutes; the Night Sky Network is read hourly.

5

MKO AllSky · Live

The live sky over MKO.

What it shows

  • Pictures from two all-sky cameras inside the lens circle: AllSky-1 and AllSky-2 (switch with the buttons at the lower right, or the A key). The header says when the picture was taken.
  • The direction key (lower left) shows N, NE, E ... as they lie in the picture: north up, east on the left, as when looking up.
  • AllSky-2 also shows Dew heater ON/OFF under the header.

Where the data comes from

  • The cameras upload to martzobservatory.org; the dashboard copies each picture, checks it is complete and the right size, and keeps the last good one if not.
  • AllSky-2's Raspberry Pi runs its dew heater from sunset minus 30 minutes until sunrise and reports its state.

How often

Pictures every few minutes; heater state every 2 minutes.

6

Sun

The Sun today, and space weather.

What it shows

  • Picture of the Sun in visible light (SDO/HMI); the header names who supplied it. Rise, Set, Alt, Az.
  • X-ray = solar flare class; SSN = sunspot number; Kp = geomagnetic activity (0-9); Aurora = chance of seeing it from MKO. Astro dark / Astro dawn = start and end of full darkness.

Where the data comes from

  • Picture: the SOHO or SDO mirrors, or Helioviewer when they are stale, whichever has the newest.
  • X-ray, SSN, Kp and aurora: NOAA Space Weather Prediction Center. Rise/set/alt/az: Skyfield.

How often

Picture and space weather every 5 minutes; positions every minute.

7

Moon

The Moon tonight.

What it shows

  • Moon picture for this hour, phase name, percent illuminated, age in days, rise, set, alt/az, next Full and New Moon.
  • The night bar runs from sunset to sunrise: darker shading = full darkness, yellow tint = Moon above the horizon, cyan ticks = the Moon-free dark window, white tick = now.

Where the data comes from

  • Picture: NASA Scientific Visualization Studio, 'Moon Phase and Libration' (one frame per hour). Everything else: calculated with Skyfield.

How often

Picture hourly; numbers every minute.

8

On-Site Weather

Is it safe to open the roof?

What it shows

  • A big sky word (Clear / Cloudy / Very cloudy, or Rain), then 'Safe to open roof' or 'Unsafe: reasons', with the readings behind them: sky minus ambient temperature, ambient, dew point, wind, humidity, rain, daylight and pressure (in hPa and inHg, with an arrow for the 3-hour trend: rising, steady or falling; orange for a rapid fall).
  • If the sensor stops answering for 15 minutes the panel says OFFLINE instead of showing old values.

Where the data comes from

  • MKO's Boltwood Cloud Sensor III, read-only over its own web interface. 'Safe' is worked out from its readings and its own limits; it is advice for people, not a control.

How often

Every minute.

9

Regional Radar

Rain and storms near MKO.

What it shows

  • A map centred on MKO with a looping radar picture of the last hour (frames 5 minutes apart), range rings at 25 and 50 km, and nearby towns.

Where the data comes from

  • NOAA MRMS quality-controlled radar (clutter such as wind farms removed); base map from the USGS National Map, lakes and state line from Natural Earth.

How often

Every 5 minutes.

10

Clear Sky Chart

Will the sky be good?

What it shows

  • A 48-hour grid for cloud cover, transparency, seeing, darkness, wind, humidity (and smoke when there is some). Colours run poor to good; hover a square for its value.
  • The 'Tonight' line names the longest run of good hours and warns about Moon, dew or smoke.

Where the data comes from

  • Forecast numbers from cleardarksky.com for the MartzObs chart (Attilla Danko; forecast by A. Rahill, Environment Canada), redrawn by the dashboard.

How often

Rechecked every 10 minutes; a new forecast is downloaded when one is published.

Data sources

Where the data comes from

SourceWhat we take from itPanelRefreshed
NOAA Space Weather Prediction CenterX-ray flares, sunspot number, Kp, aurora65 min
NASA SOHO / SDO mirrors, Helioviewer.orgPicture of the Sun65 min
NASA Scientific Visualization StudioMoon phase and libration pictures7hourly
NASA/JPL DE421 ephemeris (via Skyfield)Positions of Sun, Moon, planets; twilight; rise/set; LST2, 3, 6, 7every minute
CelesTrakSatellite orbits312 hours
NASA Night Sky NetworkMKO events calendar4hourly
MKO /dso catalog + OpenNGCDeep-sky objects and their coordinates2weekly
MKO AllSky cameras (AllSky-1, AllSky-2)Live pictures; AllSky-2 dew heater state5minutes
Boltwood Cloud Sensor III at MKOSky, wind, rain, humidity, pressure readings81 min
NOAA MRMS radar; USGS; Natural EarthRadar frames and base map95 min
cleardarksky.com (A. Danko; Environment Canada)Observing forecast1010 min

All of it is public data used read-only. Credits are shown where required: Helioviewer.org is named in the Sun panel header; cleardarksky.com and its authors in the Clear Sky Chart; NOAA MRMS, USGS and Natural Earth in the Radar panel's hover tip; OpenNGC in Up Tonight.

Built with

What it's built with, and where to find it

ComponentWhat it does hereLicenceWhere to find it
The page (in your browser)
Plain HTML, CSS, JavaScriptThe whole page; no framework, no build step.Written hereweb/ folder of the project
Inter and Oswald fontsText and headings, kept on the MKO server (none loaded from Google).SIL OFLrsms.me/inter
fonts.google.com/specimen/Oswald
The calculations (on the server)
SkyfieldSun, Moon, planets, rise/set, twilight, sidereal time, satellite passes.MITrhodesmill.org/skyfield
NumPy, jplephem, sgp4Array maths, planet data, satellite orbits (all used by Skyfield).BSD / MITnumpy.org
pypi.org/project/jplephem
pypi.org/project/sgp4
JPL DE421 ephemerisNASA/JPL table of planet and Moon positions.Publicssd.jpl.nasa.gov/planets/eph_export.html
The server
Ubuntu Linux and Apache HTTP ServerServes the page and decides what is public; cron runs the scripts. Shares the server with the WordPress site but does not use it.Open sourceubuntu.com
httpd.apache.org
rsync and OpenSSHCopy new versions to the server; the Pi sends its heater state with scp.Open sourcewww.openssh.com
Open data and maps
OpenNGCPositions of deep-sky objects.CC BY-SA 4.0github.com/mattiaverga/OpenNGC
Natural Earth; USGS The National MapLakes and state line; the topographic radar base map.Public domainwww.naturalearthdata.com
www.usgs.gov (The National Map)
HelioviewerFallback picture of the Sun.Free public servicehelioviewer.org
MKO's own AllSky cameras (local)
Allsky (AllskyTeam)Software that runs MKO's own cameras, takes and uploads the pictures, and runs the dew heater script on AllSky-2's Raspberry Pi.Open sourcegithub.com/AllskyTeam/allsky
ZWO ASI678MC and ASI676MCMKO's two all-sky cameras (AllSky-1 and AllSky-2).Hardwarewww.zwoastro.com
sunwait; pinctrlSunrise/sunset for the heater; switches the Pi's GPIO pin.Open sourcegithub.com/risacher/sunwait
github.com/raspberrypi/utils
MKO's weather sensor
Boltwood Cloud Sensor IIIMKO's own sensor: sky, wind, rain, humidity and pressure readings, read-only.Hardwarediffractionlimited.com/cloud-sensor

The dashboard's own code: the scripts (fetch/), the web page (web/) and the install scripts (deploy/); notes in CLAUDE.md and docs/. All of the above is free or open source except the hardware.

Using it

Controls, and reading the signals

Controls

  • Night Mode: the Night button, the N key, or ?night=1 at the end of the address. Everything turns red-on-black; the choice is remembered.
  • AllSky camera: the AllSky-1 / AllSky-2 buttons at the lower right of the picture, or the A key (?allsky=1 or ?allsky=2 picks one). It opens on AllSky-2.
  • Guide link: the Guide link beside the Night button (shown when a mouse or touch screen is present) opens the online version of this guide in a new tab: martzobservatory.org/mko-dashboard/guide.
  • Hover tips: with a mouse, items with a dotted underline (and the planet rows) explain themselves. The kiosk has no mouse, so nothing depends on them.
  • Daily refresh: the page reloads itself at 4 AM so a kiosk always runs the latest version.

What the colours and warnings mean

  • Orange header text: that panel's data is old (for example 'Boltwood · 25 min old', or 'AllSky-2 · updated: 25 min ago').
  • Red warning where the date is: the whole system stopped updating, or the server can't be reached.
  • Dimmed rows or values: not current or not viewable: a planet that is not up tonight, or a space-weather value whose feed went quiet.
  • On-Site Weather: 'Safe to open roof' (green) or 'Unsafe: reasons' (orange, with the readings behind each reason highlighted). A gray OFFLINE means no reading for 15 minutes. It is advice only.
  • Dew heater line: ON in yellow, OFF in gray; orange 'no update' if the AllSky-2 Pi stops reporting.

Night Mode

The dashboard in Night Mode, all red on black
Night Mode keeps every picture and chart in shades of red only.

Questions & terms

Questions people ask

Why are some planets dimmed?

A bright row means the planet is viewable tonight: at least 10° above the horizon at some time from now until sunrise (twilight counts as night). A dim row is not: it stays low or below the horizon. Hover over a row to see the viewing window, or why it is dim.

How do I read the deep-sky table?

It is a planning list for imaging: ID is the catalog number, Con the constellation and Object the name; 'Above 30°' gives the first and last time tonight (in the dark) that the object is at least 30° up, and Hours how long that is. The objects with the longest time up come first, so a long window means a relaxed evening and a short one means it is only up briefly. A name like 'Open cluster' is the catalog's own generic description.

What do Dark and Peak mean in the planets table?

Dark is the planet's height an hour after full darkness begins, or right now once it is dark; Peak is the highest it gets tonight. A dash means it is below the horizon then.

Why do the planets' Rise and Set times show no day?

For a planet below the horizon they are its next rise and the set after it, which may well be tomorrow. For a planet that is up, they are the rise that already happened and the coming set.

What does orange text in a panel's header mean?

That panel's data is getting old, for example 'Boltwood · 25 min old'. The dashboard would rather show you the age than pretend old data is fresh.

What is the warning where the date normally is?

The whole dashboard has stopped updating, or the server can't be reached. Without it, numbers such as the Sun's altitude would freeze while the clock keeps ticking.

Does 'Safe to open roof' control anything?

No. It is advice worked out from the Boltwood sensor's readings and its own limits (cloud, wind, daylight, rain, humidity, pressure, sensor voltage). The dashboard never controls the roof, the dome or the telescope; always use your own judgement.

Why does the Sun picture name different sources?

Three sources supply pictures of the Sun (NASA's SDO, the SOHO mirror, and Helioviewer) and the dashboard uses whichever has the newest. Helioviewer's picture is grayscale, so it is tinted orange to match NASA's. Helioviewer's can be a few hours behind; the others are usually minutes behind.

Why does AllSky-2 show a Dew heater line?

AllSky-2's dome has a heater that keeps dew and frost off it. It runs from 30 minutes before sunset until sunrise, and the camera's Raspberry Pi reports its state every 2 minutes. If the reports stop, the line turns orange ('no update').

Why is the AllSky picture smaller at night?

AllSky-2's camera changes its settings at night (it combines pixels, called binning), which makes a smaller picture. The dashboard accepts both sizes and shows the same circle.

Why is the bottom of AllSky-1's circle cut flat?

AllSky-1's camera frame ends before its circle does, so there is nothing more to show there.

Which way is east in the AllSky pictures?

On the left, with north at the top, as when you lie on your back and look up. The direction key in the lower left of the picture shows it.

How do I start in Night Mode, or on a particular camera?

Add ?night=1, ?allsky=1 or ?allsky=2 to the address. The N and A keys switch them while you watch.

How often does it update?

The page reads new data every 30 seconds. Each panel's own data is refreshed as listed on its card in this guide, from once a minute to once an hour.

Can I use it on a phone?

It is laid out for a 1920 × 1080 screen and shrinks to fit, so a tablet or computer works best. On a phone it works but is small.

Who do I tell about a problem?

Andy Felong, andy@martzobservatory.org.

A few words explained

Alt / Az Height above the horizon / compass direction (0° = north, 90° = east).
LST Local sidereal time: which part of the sky is crossing the meridian (the north-zenith-south line) right now.
JD Julian Date: a running day count astronomers use for timing.
Mag Brightness: smaller numbers are brighter; Venus is about -4, the faintest naked-eye stars about +6.
Dark / Peak In Up Tonight and Satellite Passes: Dark = height an hour after astronomical dark begins (Now once it is dark); Peak = the highest height reached (planets: tonight; a satellite: during the pass).
Con The constellation an object lies in, as a three-letter abbreviation: Per = Perseus, Cas = Cassiopeia, And = Andromeda, Tau = Taurus, Lac = Lacerta.
DSO Deep-sky object: a galaxy, nebula or star cluster.
Kp Geomagnetic activity from 0 to 9; 5 or more is a storm.
SSN Sunspot number.
X-ray class Solar flare strength: A, B, C, M, X (each ten times stronger than the one before).
Transparency / seeing How clear the air is / how steady it is (sharpness of star images).
Astro dark When the Sun is 18° or more below the horizon: full darkness.
Dew heater Warms the AllSky-2 dome so dew and frost don't form on it.

About & credits

Who made this

The dashboard and this guide were designed, directed and tested by Andy Felong. The code, text and documentation were written with the help of Claude, an AI assistant made by Anthropic, which also helped identify the open-source components used and checked the work for errors.

About the developer

Andy Felong is a volunteer and board member of the Martz-Kohl Observatory, which is run by the Marshal Martz Memorial Astronomical Association, Inc., a 501(c)(3) nonprofit, in Frewsburg, New York.

A mostly retired software engineer with more than 40 years of experience, Andy began by writing real-time imaging software for the Voyager spacecraft at the Jet Propulsion Laboratory and went on to lead engineering teams at Apple, Oracle, Walmart.com and Agile Mind. At the observatory, Andy built, installed and maintains the MKO AllSky cameras, and created the Wonders of the Deep Sky and Navigating the Stars web apps. Andy writes about Raspberry Pi and astronomy projects at andyfelong.com.

Questions, corrections or ideas: andy@martzobservatory.org

The data comes from the public services listed above; thank you to everyone who makes them available. The guide's fonts (Cinzel, Crimson Pro, Audiowide) are used under the SIL Open Font License.

Sky positions are calculated with Skyfield and NASA/JPL's DE421 ephemeris; deep-sky data comes from OpenNGC and the /dso catalog. The full list is under Built with.

More from the observatory

↑ Top