Main Page: Difference between revisions

From Global Meteor Network
Jump to navigation Jump to search
Line 125: Line 125:
* The code was designed to run on a RPi, but it will also run an some Linux distributions. We have tested it on Linux Mint 18 and Ubuntu 16. For information on installing into other Linux releases, check portions of the section listed below for installing on RPi, and also check installation instructions found on [https://github.com/CroatianMeteorNetwork/RMS GitHub]
* The code was designed to run on a RPi, but it will also run an some Linux distributions. We have tested it on Linux Mint 18 and Ubuntu 16. For information on installing into other Linux releases, check portions of the section listed below for installing on RPi, and also check installation instructions found on [https://github.com/CroatianMeteorNetwork/RMS GitHub]


== Build the software from scratch (not for the faint-hearted) ==
== Install the software from scratch ==


If you'd like to install RMS on the RPi from scratch (not recommended), you can follow these installation instructions:
'''Note: if you're setting up a Rspberry Pi you should use the prebuilt image as this comes with all necessary software installed and is ready to use.'''. If you really do want to install on the RPi from scratch, you can follow the instructions below:


=== Install for Raspberry Pi 3 ===
=== Install for Raspberry Pi 4 ===


'''We no longer recommend the Pi3, as it doesn't have the performance or memory to handle busy meteor showers. For example during the Perseids the Pi may spend all day trying to catch up with data processing. '''
Detailed instructions [https://docs.google.com/document/d/19ImeNqBTD1ml2iisp5y7CjDrRV33wBeF9rtx3mIVjh4/edit?usp=sharing here]


However, if you do want to use a Pi 3 please use the prebuilt image as this comes with all necessary software installed and is ready to use. However, if you really want to start from scratch there are instructions [https://docs.google.com/document/d/1ChaXx6WkuGfcQ_f5yRbwUOOMxEgIJrjq932UZE6cRjE/edit here].
===  Install for Raspberry Pi 3 ===


=== Install for Raspberry Pi 4 ===
'''We no longer recommend the Pi3, as it doesn't have the performance or memory to handle busy meteor showers. '''


'''In most circumstances, you should use the prebuilt image as this comes with all necessary software installed and is ready to use.''' However, if you really want to start from scratch there are detailed instructions [https://docs.google.com/document/d/19ImeNqBTD1ml2iisp5y7CjDrRV33wBeF9rtx3mIVjh4/edit?usp=sharing here]
Detailed instructions [https://docs.google.com/document/d/1ChaXx6WkuGfcQ_f5yRbwUOOMxEgIJrjq932UZE6cRjE/edit here].


=== Install for Linux ===
=== Install for Linux ===
Line 144: Line 144:


=== Installation for Windows ===
=== Installation for Windows ===
Data capture does not work under windows. However you can use the other tools on your PC, where its much quicker to run SkyFit2 to calibrate your camera to the sky, or you want to use BatchFFToImage to convert data to jpeg format to share on Social Media,
Data capture does not work under windows. However you can use the other tools on your PC, where its much quicker to run SkyFit2 to calibrate your camera to the sky, or you want to use BatchFFToImage to convert data to jpeg format to share on Social Media.  
 
Click '''[[Windows_Installation|here]]''' for detailed instructions.


As noted, data capture and meteor detection does not work under windows! If you are a Windows whizz, please feel free to investigate why this doesn't work.  
Click '''[[Windows_Installation|here]]''' for detailed instructions. The instructions were tested on Windows 10 64-bit, but should work on any Windows version where git and Anaconda are available.  


Finally: these instructions have been tested on Windows 10 64-bit but should work for any version of Windows that Anaconda and Git are available for.
Aside: If you are a Windows whizz, please feel free to investigate why data capture doesn't work!


=== Installation for MacOS ===
=== Installation for MacOS ===
Installation for MacOS is optional as it is for Windows. If you do want to install it, please follow the instructions '''[[MacOS_Install | here]]'''.
As with Windows, installation for MacOS is useful if you want to analyse the data offline. If you do want to install it, please follow the instructions '''[[MacOS_Install | here]]'''.


== FAQ ==
== FAQ ==

Revision as of 04:36, 28 August 2021

Welcome to the Global Meteor Network's wiki page!

The Global Meteor Network (GMN) is a world wide organization of amateur and professional astronomers alike, whose goal is to observe the night sky using low-light video cameras and produce meteor trajectories in a coordinated manner. Here you will find information on the purpose and structure of the GMN, assembling and operating your own meteor camera, contributing to the development of RMS the GMN software, as well as information on how your observations as a citizen scientist can contribute to the further understanding of our solar system's formation and evolution.

If you have come here to find out how to build and setup a camera from scratch, jump ahead to this section !


Global Meteor Network Overview

Our mission

A brief history of the Global Meteor Network

Video overview - Meteor tracking and the GMN from Astro Imaging Channel presentation

Some 'live' GMN data products

Meteor Detection Station

What is an RMS GMN station?

A RMS-based GMN station that is the subject of this Wiki consists of a Raspberry Pi (RPi) single board computer, a low light level security video camera, and the RMS software package. The camera is securely mounted in a weatherproof housing, pointed at the sky, and connected to the RPi with a POE (Power Over Ethernet) cable. The RPi is connected to the Internet via WiFi, and to be a part of GMN network, you’ll need a fairly powerful Raspberry Pi (RPi 3B+, RPi 4 or better) and a reasonably fast Internet connection. The internet connection is primarily required to enable data upload to a central server each morning as well as provide automatic updates for the RMS software.
Nightly, the RPi starts recording video from the camera shortly after local sunset continuously compressing and storing the video data locally. Each morning before sunrise, after capture is complete, the RPi analyzes the video and extracts your nightly station’s meteor observations. These extracted video “clips” of detected meteors are then archived and uploaded to a server. The clips can total hundreds of megabytes on a “busy” night (e.g., in a heavy meteor shower, or a night with a lot of false detections--progress is being made on the detection software). The server finds meteors which were observed with more than one station and this enables the server to triangulate the meteor trails in 3D and calculate the orbits of the meteors.

What do I need?

You'll need a Raspberry Pi with the software on, and a camera kit. We strongly recommend the Pi4 model. The software will run on a Pi3 but it is much slower.

How do I obtain a camera?

There are two options:

Buy a Camera

You can buy a camera and Pi prebuilt and ready to install. These are available from a couple of suppliers. The Croatian Meteor Network sell prebuilt cameras as explained on this page. Alternatively, if you're in the UK, you can obtain cameras from the UK Meteor Network

Build your own from scratch

This requires some basic DIY skills and some familiarity with the Raspberry PI, but don't be put off. The instructions are comprehensive and if you get stuck, you can ask for advice in the groups.io forum.

Click on this link if you want to build a camera from scratch.

Once you've built the camera, You can flash a Prebuilt image onto an SD card to set up the Pi with the software required to capture meteors and upload data to the network.

Can I use a commercial all-sky camera?

Generally no due to the lack of sensitivity. But see this recent experiment

Operating and maintaining your GMN station

Overview

Please note that GMS is a nascent operation and you may share some growing pains if you choose to be involved -- we're still working out some bugs and making improvements here, which may be an opportunity to help if you have programming skills! ;-) So note that the workload of day-to-day operation can be non-zero, and might take a little bit of your time.
Ideally, you'll want to monitor your RMS RPi system(s) daily to look for freezes or glitches or other problems... like birds nesting or soiling the camera window, people accidentally unplugging the power cord, mice (or cats or dogs!) chewing on the camera Ethernet cable, etc.
Although we are getting close, this is not a "power up and forget about it" system yet.
However, by its very nature, the GMS network is inhabited by a lot of people who are willing to help newcomers getting started. So, here are some clues for daily operation of your RMS camera.

So what does the meteor camera do over the course of 24 hours?

The RMS Python based system calculates the sundown to sunrise interval and schedules video camera capture all night long. Depending on the video camera and capabilities of the RPi, the camera captures 25 or more frames per second between evening and morning twilight. During the continuous image capture, the station begins processing captured image data, doing a pre-screening to target frames with a suitable number of stars (usually around 20) that makes it worth looking for meteor detections. Once data capture has finished, the station switches into processing all the promising frames for detections, then refining the astrometric accuracy of every positive detection. Using the station platepar (plate parameters) calibration file, processing iterates to find the best astrometry and photometry solution for each detected meteor. Once this process has analyzed each detection, summary files are created.
These summary files include text file data presentation in several widely accepted formats (CAMS and UFOorbit), as well as graphic plots of detection frequencies throughout the night, a set of thumbnail images of detections, a set of thumbnail images of data captured throughout the night, a single image with all detections stacked together, plots of photometry, astrometry, and camera pointing drift in arc minutes throughout the course of the night as the mount or building flexes, a flat file for correcting images, and a plot of all detections showing any identified radiants. Finally all results are combined into a single compressed archive, which is automatically uploaded each morning to the central server. Optionally, you can create a mp4 movie showing a time lapse of the night’s captured images.
Each morning you can review the result files on the RPi, and copy anything you want to your computer or tablet.

Archiving data and backing up configuration

Data backup is as much or as little as you like. Your primary data is automatically uploaded to the central server every morning when data processing is done. We've built some automated tools that can help to back up any additional data to a thumb drive inserted into the RPi.

Viewing the data

To view the data, you can use CMN_binViewer software[1] which is already installed in the RMS SD image.
There is also a Windows version[2] you can install.

Tools and Utilities

  • RealVNC or AnyDesk remote connect tool allows station access from anywhere. Access from outside your network is enabled by use of an OpenVPN connection address available to meteor stations. Alternatively, with VNC and Teamviewer, you can create an account and team on their websites, and then remotely access your station.
  • Samba data directory access, allows you to copy data results directly from your RPi to your computer or tablet.
  • CMN_binViewer can be used to view standard fits image files containing meteor detections. It runs on the RPi, and is also available under Windows.
  • UFO Orbit allows you to process data from multiple stations and generate unified radiants of two or more stations seeing the same meteor. It can plot the shared object ground path, orbital characteristics, and can output a summary file of all objects seen by more than one station, which can be used for further analysis.
  • RMS software can be installed under Windows to allow much of the RMS python-based code to be executed on your computer, so it can be run against meteor station data you have transferred to your computer from the RPi.
  • You can run RMS Python jobs on the RPi to sample the image files captured all night long and condense them into a mp4 movie. This creates a sometimes mesmerizing summary that can run for over 2 minutes in length for winter time data.

Configuring and installing your camera

Quick start guide

Focusing your IP camera

Video tutorial - Configuring your IMX291 IP camera

Different ways of connecting the camera

What can I do with my GMN station?

Video Tutorial - Using SkyFit2 to perform astrometric and photometric calibration + Manually reducing observations of fireballs and computing their trajectories

Generating a Google Earth KML file to show your station's field of view

Using UFO Orbit program to estimate meteor trajectories

Urban meteor observing

RMS Software Installation

Flash a pre-built image

Pre-built Images are available with the RMS software pre-installed on Raspbian. Raspbian is the operating system typically used on the Raspberry Pi.

A 128 GB microSD card is preferred, although smaller 64 GB cards will also work. The image is flashed to the microSD card using the Etcher utility for Windows (32 or 64-bit), MacOS or Linux (64-bit), which can be found here

When you first boot up the Pi make sure you have a keyboard, monitor and mouse attached as you will be taken through a setup process by the RMS software.

The current publicly released images of RMS are: RPi3B+ and RPi4 .

Please see the Quick Start Guide about how to flash them to an SD card.

Notes:

  • The earlier versions of the Raspberry Pi, the 1 and 2, are not powerful enough to run RMS software.
  • the pre-installed RMS software images incorporate an auto-updating feature, so that the RMS software is updated to the current release whenever your Raspberry Pi RMS is booted. This way, your station is always running the most recent set of updates.
  • For installations into other Linux or windows environments, executing the command git pull will update to the most recent RMS release.
  • The code was designed to run on a RPi, but it will also run an some Linux distributions. We have tested it on Linux Mint 18 and Ubuntu 16. For information on installing into other Linux releases, check portions of the section listed below for installing on RPi, and also check installation instructions found on GitHub

Install the software from scratch

Note: if you're setting up a Rspberry Pi you should use the prebuilt image as this comes with all necessary software installed and is ready to use.. If you really do want to install on the RPi from scratch, you can follow the instructions below:

Install for Raspberry Pi 4

Detailed instructions here

Install for Raspberry Pi 3

We no longer recommend the Pi3, as it doesn't have the performance or memory to handle busy meteor showers.

Detailed instructions here.

Install for Linux

Detailed instructions here

Installation for Windows

Data capture does not work under windows. However you can use the other tools on your PC, where its much quicker to run SkyFit2 to calibrate your camera to the sky, or you want to use BatchFFToImage to convert data to jpeg format to share on Social Media.

Click here for detailed instructions. The instructions were tested on Windows 10 64-bit, but should work on any Windows version where git and Anaconda are available.

Aside: If you are a Windows whizz, please feel free to investigate why data capture doesn't work!

Installation for MacOS

As with Windows, installation for MacOS is useful if you want to analyse the data offline. If you do want to install it, please follow the instructions here.

FAQ

What should I back up when re-flashing an SD card?

The .config, platepar and mask files that are in the RMS source directory, plus the whole contents of the hidden directory /home/pi/.ssh.

If your SD card fails or becomes corrupted, the config files can be fetched from the server as they are uploaded every day together with the data. However the contents of .ssh are essential for connection to the server, so you must also save these. Once you set up a new SD card, return the files in their original location.

What are the values in FTPdetectinfo_* file designated as hnr mle bin Pix/fm Rho Phi?

Some of these values are not used in RMS (hnr mle bin), but they are in CAMS, so they are here to conform to the standard. Thus they are all zeros. The others are:
- Pix/fm - Average angular speed of the meteor in pixels per frame.
- Rho, Phi - Parameters that define the line of the meteor in polar coordinates, see here for more details. Rho is the distance of the line from the centre of the image, and phi is the angle of the line as measured from the positive direction of the Y axis (basically a line going from the center of the image to the top of the image), the positive angles are measured clockwise (I think, the CAMS standard might define these parameters a bit differently, the Y axis is flipped).
The intensity is the sum of all pixel intensities of the meteor on a given frame. Let's say I represent an area around the meteor on a given frame like this, where the numbers are pixel intensities on an 8-bit image (so they can range from 0 to 255):
Intensity_sum.png
and the pixels values inside the red boundary represent the meteor blob on the frame, the intensity would be the sum of all numbers inside the red boundary.
This value is later used to compute the magnitude. The magnitude is computed as: mag = -2.5*log10(intensity sum) + photometric_offset. The photometric offset is estimated in SkyFit by fitting the line with slope -2.5 through pairs of known magnitudes of stars and logartihms of their pixel intensity sum. The photometric offset is basically the intercept of that line. The constant slope of -2.5 comes from the definition of stellar magnitudes.


GMN data policy

The Global Meteor Network produces several levles of data products:

  • Level 1 - The lowest level data (i.e. as close to "raw" as possible) are the FF image and FR video files saved to the RPi by the capture code and the fireball detector.
  • Level 2 - The meteor detector uses these data to extract positional and brightness information of individual meteors (FTPdetectinfo file), and images are also used for astrometric and photometric calibration (platepar file). Meteor and star detections are used to generate a range of plots suchs as the single-station shower association graph, camera drift graph, etc. The calibrated meteors measurements get uploaded to the GMN server together with the raw images of individual meteors.
  • Level 3 - The software on the server correlates individual observations and computes multi-station meteor trajectories which are published daily on the GMN data website. This data is made public under the CC BY 4.0 license.

Operators of individual GMN stations exclusivery own the Level 1 and Level 2 data their stations produce. In practice, this means that they are free to share this data with other meteor networks if they wish to do so. The data that gets uploaded to the GMN server will not be shared publicly nor with other parties without the operator's consent, but may be used internally by the GMN coordinators to manually produce other data products (e.g. trajectory of a meteorite dropping fireball, analysis of a meteor shower). All station operators will be credited for their data in all GMN publications.

IstraStream

IstraStream GMN status website

The IstraStream.com is an independent hosting site which is part of our world wide GMN. It is primarily a host for data from cameras sold by IstraStream, but other station operators can request that their data be included.

To enable the IstraStream upload, simply change the config file as follows:

; External script
; An external script will be run after RMS finishes the processing for the night, it will be passed three arguments:
; captured_night_dir, archived_night_dir, config - captured_night dir is the full path to the captured folder of the night
; the second one is the archived, and config is an object holding the values in this config file.
; ---------------
; Enable running an external script at the end of every night of processing
external_script_run: true  ; <--- CHANGE
; Run the external script after auto reprocess. "auto_reprocess" needs to be turned on for this to work.
auto_reprocess_external_script_run: false
; Full path to the external script
external_script_path: /home/pi/source/RMS/iStream/iStream.py  ; <--- CHANGE
; Name of the function in the external script which will be called
external_function_name: rmsExternal


; Daily reboot
; ---------------
; Reboot the computer daily after the processing and upload is done
reboot_after_processing: false   ; <--- CHANGE

Then, send an e-mail to info@istrastream.com with your:

  • Station_ID
  • Location or Name (if not secret)
  • Lens type/size

For example, "CA0001; Elginfield Observatory, Ontario, Canada; 4mm". The IstraStream crew will enable the weblog page within a few days.

Finally, this document explains what every plot on the IstraStream weblog means:

IstraStream Plots Explanation

For More Information

Contact the Global Meteor Network

Join the Global Meteor Network Forum

GMN related publications

Moorhead, A. V., Clements, T. D., & Vida, D. (2020). Realistic gravitational focusing of meteoroid streams. Monthly Notices of the Royal Astronomical Society, 494(2), 2982-2994.
Kukić, P., Gural, P., Vida, D., Šegon, D. & Merlak, A. (2018) Correction for meteor centroids observed using rolling shutter cameras. WGN, Journal of the International Meteor Organization, 46:5, 154-118.
Vida, D., Mazur, M. J., Šegon, D., Kukić, P., & Merlak, A. (2018). Compressive strength of a skirting Daytime Arietid-first science results from low-cost Raspberry Pi-based meteor stations. WGN, Journal of the International Meteor Organization, 46, 113-118.
Vida, D., Gural, P., Brown, P., Campbell-Brown, M., Wiegert, P. (2019) Estimating trajectories of meteors: an observational Monte Carlo approach - I. Theory. arXiv:1911.02979v4 [astro-ph.EP 21 Apr 2020]
Vida, D., Gural, P., Brown, P., Campbell-Brown, M., Wiegert, P. (2019) Estimating trajectories of meteors: an observational Monte Carlo approach - II. Results. arXiv:1911.11734v1 [astro-ph.EP 26 Novr 2019]
Vida, D., Mazur, M. J., Šegon, D., Zubović, D., Kukić, P., Parag, F., & Macan, A. (2018). First results of a Raspberry Pi based meteor camera system. WGN, Journal of the International Meteor Organization, 46, 71-78.
Vida, D., Zubović, D., Šegon, D., Gural, P., & Cupec, R. (2016). Open-source meteor detection software for low-cost single-board computers. In Proceedings of the International Meteor Conference (IMC2016), Egmond, The Netherlands (pp. 2-5).
Zubović, D., Vida, D., Gural, P., & Šegon, D. (2015). Advances in the development of a low-cost video meteor station. In Proceedings of the International Meteor Conference, Mistelbach, Austria (pp. 27-30).