Operation - Revision history

Parker.link1: /* Vetting artifacts */ Minor grammar fix

2026-05-29T20:11:50Z

‎Vetting artifacts: Minor grammar fix

Parker.link1: Slightly rename the Rating artifacts section

2026-05-18T00:22:26Z

Slightly rename the Rating artifacts section

Acinonyx: Removed reference to journalctl

2026-04-27T14:22:06Z

Removed reference to journalctl

Tlofbj.internet: /* Rating observations */

2025-06-20T21:02:58Z

‎Rating observations

Tlofbj.internet: A minor addition to a message under the section "Rating observations" that included a link to an improved observation classifier solution

2025-06-13T09:14:54Z

A minor addition to a message under the section "Rating observations" that included a link to an improved observation classifier solution

Fredy: /* Prerequisites */

2021-06-15T15:49:33Z

‎Prerequisites

Fredy at 12:28, 21 August 2020

2020-08-21T12:28:44Z

Fredy: /* Scheduling Observations in Standalone Mode */ Remove this session as it is deprecated

2020-08-21T09:58:08Z

‎Scheduling Observations in Standalone Mode: Remove this session as it is deprecated

Acinonyx: Replace redirection page

2020-01-20T16:27:34Z

Replace redirection page

Jebba: network screen cap, some layout

2020-01-20T03:38:53Z

network screen cap, some layout

@@ Line 76: / Line 76: @@
 **You should leave or vet waterfall as "Unknown" when by examining the waterfall it is not clear if there is or not presence of the observed satellite. Keyboard Shortcut 'u'.
-{{Message|The expected signal in the majority of the cases, should be in the center of the waterfall following a vertical straight line. Exceptions could be satellites that are recently deployed and we don't have accurate TLE or satellites that have misbehaving transmitter.}}
+{{Message|The expected signal in the majority of the cases, should be in the center of the waterfall following a vertical straight line. Exceptions could be satellites that are recently deployed and we don't have accurate TLE or satellites that have a misbehaving transmitter.}}
 {{Message|If you are unsure about an observation, click the "Discuss" button, near the top right of the observation's page; that will post a link to it on [https://community.libre.space/c/observations the Observations forum], where you can ask for feedback.

@@ Line 43: / Line 43: @@
 If it didn't work, don't feel bad -- it can take a few attempts before you get it right.  Have a look at the [[Troubleshooting]] page for tips, and don't forget to contact the community if you need help.
-==Rating observations==
+==Observations ratings==
 {{Message|The main purpose of rating observations is to know if the satellite/transmitter is alive, if it transmits in the listed frequency/ies, and if the TLEs we have are accurate.}}
@@ Line 62: / Line 62: @@
 ==Vetting artifacts==
-Currently vetting of [[Artifacts]] is only implemented for Waterfall artifact.
+Currently, [[Artifacts|artifact]] vetting is only implemented for Waterfall artifacts.
 ===Waterfall===

@@ Line 24: / Line 24: @@
 Now SSH to your ground station computer and run these steps:
-*Follow the satnogs-client logs. Depending on your setup, this might be done with <code>journalctl -f -u satnogs-client.service</code>, or <code>tail -F /var/log/supervisor/satnogs.log</code>
+*Follow the satnogs-client logs. This can be done with <code>sudo docker logs satnogs_satnogs-client -ft</code>
-*Before the observation is scheduled to start, you should see your client wake up once per minute to check for new jobs:
+*At the scheduled time for the observation, you should see the client start the SDR capture:
 <pre>
-Oct 02 00:16:02 raspberrypi satnogs-client[10124]: 2017-10-02 00:16:02,477 - satnogsclient - DEBUG - Opening TCP socket: 127.0.0.1:5011
+-04-27T14:12:22.668909000Z Found Rafael Micro R820T tuner
-Oct 02 00:16:02 raspberrypi satnogs-client[10124]: 2017-10-02 00:16:02,479 - satnogsclient - DEBUG - Sending message: [{"origin": "network", "transmitter": "uXJ8NQNcH8b9osRc
+-04-27T14:12:22.823425000Z [INFO] Opening Generic RTL2832U OEM :: 00000001...
-Oct 02 00:16:02 raspberrypi satnogs-client[10124]: 2017-10-02 00:16:02,488 - apscheduler.executors.default - INFO - Job "get_jobs (trigger: interval[0:01:00], next run at: 2
+-04-27T14:12:23.089070000Z Found Rafael Micro R820T tuner
-Oct 02 00:16:59 raspberrypi satnogs-client[10124]: 2017-10-02 00:16:59,615 - apscheduler.executors.default - INFO - Running job "get_jobs (trigger: interval[0:01:00], next r
+-04-27T14:12:24.756358000Z [INFO] Using format CF32.
-Oct 02 00:16:59 raspberrypi satnogs-client[10124]: 2017-10-02 00:16:59,661 - apscheduler.executors.default - INFO - Running job "post_data (trigger: interval[0:02:00], next
+-04-27T14:12:24.779741000Z Allocating 15 zero-copy buffers
 </pre>
-*At the scheduled time for the observation, you should see the client kick off the observation:
+*After the observation is over, the client submits the data to the SatNOGS network.
 In the SatNOGS Stage Environment, refresh the Observation page.  You should now see a waterfall plot for your data.

@@ Line 81: / Line 81: @@
 ***Malformed artifacts: In this case there are uploaded artifacts but with malformed or unexpected format, for example Audio artifact duration is different than the scheduled one.
-{{Message|Improving algorithm for automated rating is a work in progress. If you find an inconsistency you can open an issue about it or fix it in [https://gitlab.com/librespacefoundation/satnogs/satnogs-network SatNOGS Network repository]. Meanwhile, a third-party python program (MIT License) for high-accuracy waterfall classification that is readily deployable may be found and used at this [https://github.com/tlofbj/waterfall-classifier-project-v3.5cnn-lite GitHub repository by Tata Li].}}<br />
+{{Message|Improving algorithm for automated rating is a work in progress. If you find an inconsistency you can open an issue about it or fix it in [https://gitlab.com/librespacefoundation/satnogs/satnogs-network SatNOGS Network repository]. Meanwhile, a third-party python program (MIT License) for high-accuracy waterfall classification that is readily deployable may be found and used at this [https://github.com/tlofbj/waterfall-classifier-project-v3.5cnn-lite GitHub repository].}}<br />
 ==Vetting artifacts==

@@ Line 3: / Line 3: @@
 ==Scheduling your first test observation==
-=== Prerequisites ===
+===Prerequisites===
 *You've set up your [[Raspberry Pi|SatNOGS client successfully]]
@@ Line 10: / Line 10: @@
 If you've run into any problems with those steps, check out the [[Troubleshooting]] page or ask for help in [https://community.libre.space/c/satnogs the community forum], [https://riot.im/app/#/room/#satnogs:matrix.org the Matrix room], or on IRC at #satnogs on Libera Chat.
-=== SatNOGS Network ===
+===SatNOGS Network===
 [[File:Satnogs-network-cap.png|800px|SatNOGS Network Screen capture]]
@@ Line 20: / Line 20: @@
 *You can also schedule multiple observations at once for a single satellite via the [https://network.satnogs.org/observations/new/ "Observation new page"].
-=== Ground Station ===
+===Ground Station===
 Now SSH to your ground station computer and run these steps:
@@ Line 65: / Line 65: @@
 If it didn't work, don't feel bad -- it can take a few attempts before you get it right.  Have a look at the [[Troubleshooting]] page for tips, and don't forget to contact the community if you need help.
-== Rating observations ==
+==Rating observations==
 {{Message|The main purpose of rating observations is to know if the satellite/transmitter is alive, if it transmits in the listed frequency/ies, and if the TLEs we have are accurate.}}
@@ Line 81: / Line 81: @@
 ***Malformed artifacts: In this case there are uploaded artifacts but with malformed or unexpected format, for example Audio artifact duration is different than the scheduled one.
-{{Message|Improving algorithm for automated rating is a work in progress. If you find an inconsistency you can open an issue about it or fix it in [https://gitlab.com/librespacefoundation/satnogs/satnogs-network SatNOGS Network repository]}}
+{{Message|Improving algorithm for automated rating is a work in progress. If you find an inconsistency you can open an issue about it or fix it in [https://gitlab.com/librespacefoundation/satnogs/satnogs-network SatNOGS Network repository]. Meanwhile, a third-party python program (MIT License) for high-accuracy waterfall classification that is readily deployable may be found and used at this [https://github.com/tlofbj/waterfall-classifier-project-v3.5cnn-lite GitHub repository by Tata Li].}}<br />
 ==Vetting artifacts==
 Currently vetting of [[Artifacts]] is only implemented for Waterfall artifact.
-=== Waterfall ===
+===Waterfall===
-==== Status ====
+====Status====
 Once waterfall is posted back in the Network by SatNOGS Client, by default, would be unvetted. User can manually vet waterfall, in waterfall tab, using one of the next choices:
@@ Line 105: / Line 104: @@
 }}
-==== Examples ====
+====Examples====
 Below is a collection of waterfalls with possible results of observations:
@@ Line 121: / Line 120: @@
 You can see more in [[Taxonomy_of_Observations]].
-== Network Permissions Matrix ==
+==Network Permissions Matrix==
 {| class="wikitable" style="text-align:center"

@@ Line 8: / Line 8: @@
 *You've created an account on the [[Network]], created a ground station, and it's showing up as "online"
-If you've run into any problems with those steps, check out the [[Troubleshooting]] page or ask for help in [https://community.libre.space/c/satnogs the community forum], [https://riot.im/app/#/room/#satnogs:matrix.org the Matrix room], or on IRC at #satnogs on Freenode.
+If you've run into any problems with those steps, check out the [[Troubleshooting]] page or ask for help in [https://community.libre.space/c/satnogs the community forum], [https://riot.im/app/#/room/#satnogs:matrix.org the Matrix room], or on IRC at #satnogs on Libera Chat.
 === SatNOGS Network ===

@@ Line 66: / Line 66: @@
 == Rating observations ==
-Once your observation results are posted back in the Network by your satnogs-client, you should go to Network to rate your observations. Any orange marked observations need vetting by users.
+Observations are rated automatically by algorithm based on specific criteria that depend on [[Artifacts]]. There are 4 different statuses:
 *'''Good'''
-**You should mark observations as "Good" when it is clear from the waterfall and/or audio recording that a satellite is present. Keyboard Shortcut 'g'
+**"Good" status means that algorithm was able to determine the presence of the satellite in one of the artifacts of the observation.
 *'''Bad'''
-**You should mark observations as "Bad" when by examining the waterfall and/or audio it is obvious that there was no satellite detected in this observation. Keyboard Shortcut 'b'
+**"Bad" status means that algorithm wasn't able to determine the presence of the satellite in one of the artifacts of the observation.
 *'''Failed'''
-**You should mark observations as "Failed" when the station failed entirely: the waterfall and/or audio is empty or not present, or there's too much noise. Keyboard Shortcut 'f'
+**"Failed" status means that algorithm was able to determine that something went wrong during the observation. There are two cases that fall under this category:
 Below is a collection of waterfalls with possible results of observations:
 <gallery heights="400px" widths="200px">
-File:Waterfall_20657_2017-10-15T10-07-51.png|'''Good''': Satellite is visible (bars-bursts of data in the middle). ''Note that the tangent-shaped lines are local noise''
+File:Waterfall_20657_2017-10-15T10-07-51.png|'''With Signal''': Satellite is visible (bars-bursts of data in the middle). ''Note that the tangent-shaped lines are local noise''
-File:Waterfall_20534_2017-10-15T07-21-24.png|'''Bad''': Typical empty waterfall with no visible signals.
+File:Waterfall_20534_2017-10-15T07-21-24.png|'''Without Signal''': Typical empty waterfall with no visible signals.
-File:Waterfall 20499 2017-10-15T07-17-32.png|'''Good''': Although drifting, satellite is clearly visible around the center.
+File:Waterfall 20499 2017-10-15T07-17-32.png|'''With Signal''': Although drifting, satellite is clearly visible around the center.
-File:Waterfall 20506 2017-10-15T06-47-36.png|'''Good''': Faint CW signal around center-left. ''Note you might have to expand image to notice it''
+File:Waterfall 20506 2017-10-15T06-47-36.png|'''With Signal''': Faint CW signal around center-left. ''Note you might have to expand image to notice it''
-File:Waterfall_20571_2017-10-15T05-25-56.png|'''Good''': Clearly visible FM transmission. ''Note that the swinging lines are terrestrial noise''
+File:Waterfall_20571_2017-10-15T05-25-56.png|'''With Signal''': Clearly visible FM transmission. ''Note that the swinging lines are terrestrial noise''
-File:Waterfall 20483 2017-10-15T05-12-49.png|'''Good''': Straight line in the center bottom is a satellite. ''Note transmission on left bottom is the same satellite on a different frequency''
+File:Waterfall 20483 2017-10-15T05-12-49.png|'''With Signal''': Straight line in the center bottom is a satellite. ''Note transmission on left bottom is the same satellite on a different frequency''
-File:Waterfall_145037_2018-05-26T15-18-18.png|'''Good''': Packets clearly seen in the middle of the observation. ''Note transmission starting middle bottom then moving to left and back to right *is* a space object (satellite). It is not the one we are tracking though (different TLE, thus this type if curve).''
+File:Waterfall_145037_2018-05-26T15-18-18.png|'''With Signal''': Packets clearly seen in the middle of the observation. ''Note transmission starting middle bottom then moving to left and back to right *is* a space object (satellite). It is not the one we are tracking though (different TLE, thus this type if curve).''
 </gallery>
-You can see more [[Rating_Observations|examples of observations and ratings]] and a [[Taxonomy_of_Observations]].
+You can see more in [[Taxonomy_of_Observations]].
 == Network Permissions Matrix ==

@@ Line 99: / Line 99: @@
 ===Discuss===
 If you're still unsure about an observation, click the "Discuss" button, near the top right of the observation's page; that will post a link to it on [https://community.libre.space/c/observations the Observations forum], where you can ask for feedback.
 == Network Permissions Matrix ==