Operation - Revision history

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

Jebba: categories

2020-01-19T22:17:37Z

Jebba: /* Rating observations */ Taxonomy_of_Observations

2020-01-11T21:24:02Z

‎Rating observations: Taxonomy_of_Observations

@@ 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 ==

← Older revision		Revision as of 22:17, 19 January 2020
Line 169:		Line 169:

	*Station Owner with at least one online station can view and discuss on all observations. Online station owner can vet or delete observations on stations that owns. Online station owner can vet or delete observation that has scheduled. Online station owner can schedule observations on all online stations.		*Station Owner with at least one online station can view and discuss on all observations. Online station owner can vet or delete observations on stations that owns. Online station owner can vet or delete observation that has scheduled. Online station owner can schedule observations on all online stations.
		+
		+	[[Category:Operate]]
		+	[[Category:Hardware]]
		+	[[Category:Software]]

@@ Line 92: / Line 92: @@
 </gallery>
-You can see more [[Rating_Observations|examples of observations and ratings]].
+You can see more [[Rating_Observations|examples of observations and ratings]] and a [[Taxonomy_of_Observations]].
 [[File:Observation_with_discuss_button_highlighted.png|thumb|frame|Click the "Discuss" button to post in our web forum. (Note: this will only appear in the SatNOGS network.)]]