CroatianMeteorNetwork / RMS

RPi Meteor Station
https://globalmeteornetwork.org/
GNU General Public License v3.0
169 stars 47 forks source link

Feature require fr #266

Closed g7gpr closed 4 months ago

g7gpr commented 4 months ago

This pull request relates to https://github.com/CroatianMeteorNetwork/RMS/issues/240

It implements a new command to EventMonitor which only allows upload if an FR*.bin file was generated within the event window. This is intended to reduce the number of stations which upload for a bright event when the trajectory has a large uncertainty.


EventTime                : 20240209_191741
TimeTolerance (s)        : 30
EventLat (deg +N)        : -34.549697
EventLon (deg +E)        : 117.59325
EventHt (km)             : 100.5
EventLat2 (deg +N)       : -35.0
EventLon2 (deg +E)       : 117.0
EventHt2 (km)            : 30
CloseRadius(km)          : 500
FarRadius (km)           : 1000
RequireFR        : 1

END

EventTime                : 20240209_191740
TimeTolerance (s)        : 30
EventLat (deg +N)        : -34.549697
EventLon (deg +E)        : 117.59325
EventHt (km)             : 100.5
EventLat2 (deg +N)       : -35.0
EventLon2 (deg +E)       : 117.0
EventHt2 (km)            : 30
CloseRadius(km)          : 500
FarRadius (km)           : 1000
RequireFR        : 0

END

The two events are the same, except that the event at 191741 requires an FR file, but the event at 191740 does not. Station AU000A observed the event, and generated an FR file. Part of the entries of the logs are

2024/02/11 07:40:56-INFO-EventMonitor-line:1873 - Checks on trajectories for event at 20240209_191741
2024/02/11 07:40:56-INFO-EventMonitor-line:1891 - Event at 20240209_191741 requires FR file
2024/02/11 07:40:56-INFO-EventMonitor-line:1897 - Event at 20240209_191741 required FR file and file was found
2024/02/11 07:40:56-INFO-EventMonitor-line:1924 - Working without standard deviations
2024/02/11 07:40:56-INFO-EventMonitor-line:1962 - Event at 20240209_191741 was 331km away, inside 500km so is uploaded with no further checks.
~~~
2024/02/11 07:41:46-INFO-EventMonitor-line:1873 - Checks on trajectories for event at 20240209_191740
2024/02/11 07:41:46-INFO-EventMonitor-line:1899 - FR file not required for event at 20240209_191740
2024/02/11 07:41:46-INFO-EventMonitor-line:1924 - Working without standard deviations
2024/02/11 07:41:46-INFO-EventMonitor-line:1962 - Event at 20240209_191740 was 331km away, inside 500km so is uploaded with no further checks.
2024/02/11 07:41:46-INFO-EventMonitor-line:1965 - Check of trajectories time elapsed 0.05 seconds

Station AU000C did not observe the event directly.

2024/02/11 07:40:22-INFO-EventMonitor-line:1873 - Checks on trajectories for event at 20240209_191741
2024/02/11 07:40:22-INFO-EventMonitor-line:1891 - Event at 20240209_191741 requires FR file
2024/02/11 07:40:22-INFO-EventMonitor-line:1893 - Event at 20240209_191741 skipped - FR required and none found
2024/02/11 07:40:23-INFO-EventMonitor-line:1173 - Event at 20240209_191741 marked as processed

~~~
2024/02/11 07:40:23-INFO-EventMonitor-line:1873 - Checks on trajectories for event at 20240209_191740
2024/02/11 07:40:23-INFO-EventMonitor-line:1899 - FR file not required for event at 20240209_191740
2024/02/11 07:40:23-INFO-EventMonitor-line:1924 - Working without standard deviations
2024/02/11 07:40:23-INFO-EventMonitor-line:1962 - Event at 20240209_191740 was 331km away, inside 500km so is uploaded with no further checks.
2024/02/11 07:40:23-INFO-EventMonitor-line:1965 - Check of trajectories time elapsed 0.05 seconds

Therefore only the event at 191740 was uploaded, the event at 191741 was skipped.

Also EventMonitor is standardised to be capital E and capital M

The santise function is brought in, to prevent carelessly or deliberately unpleasant event specfications causing problems.

The formatting of the EventMonitor run notification is made more user friendly.

Results from testing across multiple stations

Not requiring FR file returned

au000a,c,d,e,f,g,h,u,v,w,x,y,z,1a,1b,1c,1d,1f,28,29,2a,2b,2e,2f

Requiring FR file returned

au000a,g,v,1b,1e,2b

The event specifications used for testing were

# this event is to test the new RequireFR command

EventTime                : 20240209_191753
TimeTolerance (s)        : 30
EventLat (deg +N)        : -34.549697
EventLon (deg +E)        : 117.59325
EventHt (km)             : 100.5
EventLat2 (deg +N)       : -35.0
EventLon2 (deg +E)       : 117.0
EventHt2 (km)            : 30
CloseRadius(km)          : 500
FarRadius (km)           : 1000
RequireFR        : 1

END

EventTime                : 20240209_191754
TimeTolerance (s)        : 30
EventLat (deg +N)        : -34.549697
EventLon (deg +E)        : 117.59325
EventHt (km)             : 100.5
EventLat2 (deg +N)       : -35.0
EventLon2 (deg +E)       : 117.0
EventHt2 (km)            : 30
CloseRadius(km)          : 500
FarRadius (km)           : 1000
RequireFR        : 0

END