Difference between revisions of "SatNOGS DB"

From SatNOGS Wiki
m (Ppapadeas moved page Add Satnogs DB to Satnogs DB)
(* [https://libre.space/2020/03/02/space-situational-awareness/ Space Situational Awareness – The story so far and an open way forward])
(18 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[https://db.satnogs.org/ SatNOGS DB] is an effort to create an hollistic, unified, global transmitter database for all satellite transmitters. You can export the data or even connect your application using our API. It's part of the SatNOGS project.
+
__NOTOC__
 +
 
 +
== Introduction ==
 +
 
 +
[https://db.satnogs.org/ SatNOGS DB] is an effort to create a holistic, unified, global transmitter database for all satellite transmitters. You can export the data or even connect your application using our API. It's part of the SatNOGS project.
 +
 
 +
[[File:Satnogs-db-cap.png|800px|SatNOGS DB Screen capture]]
  
 
==Data==
 
==Data==
 
The DB is open to everyone. Anyone is able to submit suggestions or use the existing Transmitters. All data are public and freely under the Creative Commons Atribution-Share Alike license.
 
The DB is open to everyone. Anyone is able to submit suggestions or use the existing Transmitters. All data are public and freely under the Creative Commons Atribution-Share Alike license.
  
==Installation==
+
==Contribute==
 +
 
 +
===Adding Satellites===
 +
If you are a moderator you can add new satellites on the DB. For that follow the instructions:
 +
 
 +
#Log in to db.satnogs.org
 +
#Navigate to https://db.satnogs.org/admin (if you are seeing a login screen, you are either not logged in to db.satnogs.org, or don't have moderator permissions)
 +
#Click on Base::Satellite [https://db.satnogs.org/admin/base/satellite/add/ Add button]
 +
#Complete the information to the best of your knowledge. Norad ID and Name are mandatory. Add multiple names on the "Names" field.
 +
#Click Save and you are done!
 +
#You can now move on to the next steps: suggesting and approving transmitters for this satellite.
 +
 
 +
Note:  this process may change in the future; see [https://gitlab.com/librespacefoundation/satnogs/satnogs-db/issues?milestone_title=Improved+User+Experience the Gitlab issues list] for details.
 +
 
 +
===Suggesting transmitters===
 +
[[File:Db transmitter suggestion.png|center|thumb]]
 +
We rely on crowd-sourced information to keep our transmitter details up to date. Anyone with a SatNOGS login can submit transmitter details. Moderators are notified and approve submissions frequently.
 +
<br />
 +
 
 +
*Description: This is the name that will appear for this transmitter across DB, Network, and API users. Please use the following notations
 +
**Band, for instance VHF,  or for a transceiver, MODE U/V
 +
**Baud (if applicable), in the format 9k6 for 9600
 +
**Mode, for instance FSK
 +
**Rough type description, ie TLM for "telemetry", or "FM Transponder" for repeater
 +
**Examples
 +
***UHF 9k6 FSK TLM
 +
***MODE U/V FM Transceiver
 +
***VHF CW TLM
 +
*Status
 +
**Active: alive and well
 +
**Inactive: not functional or powered down
 +
**Invalid: this is a legacy transmitter that should be hidden from UI
 +
*Type
 +
**Transmitter: one-way downlink (telemetry)
 +
**Transceiver: repeats an uplinked signal intact
 +
**Transponder: interacts with an uplinked signal or downlinks after signal modification
 +
*Downlink: Published frequency, in Hz
 +
*Downlink Drifted: Observed frequency, or what frequency should be used to properly tune (with doppler correction). In most cases this should be the same as the Downlink frequency. This field '''must be entered''' even if there is no drift.
 +
*Mode: The modulation mode for this transmitter
 +
*Baud rate: the baud rate, if applicable. If this is a CW beacon, use WPM
 +
*Citation URL: a URL to link to in providing the details for your suggestion.
 +
 
  
===[http://docs.satnogs.org/db/installation-docker.html Docker Installation]===
+
===Approving transmitters===
 +
If you are a moderator you can approved suggestions for transmitters. For that follow the instructions:
  
===[http://docs.satnogs.org/db/installation-virtualenv.html VirtualEnv Installation]===
+
#Log in to db.satnogs.org
 +
#Navigate to https://db.satnogs.org/admin (if you are seeing a login screen, you are either not logged in to db.satnogs.org, or don't have moderator permissions)
 +
#Click on Base::Suggestions
 +
#Click on the suggestion you want to review and carefully check the data, especially the citation URL
 +
#When you are ready to approve or reject the suggestion, go back to the [https://db.satnogs.org/admin/base/suggestion/ full list of suggestions]
 +
#Select the suggestions you want to act upon and from the drop down above either approve them or reject them
 +
#You are done!
  
==Contribute==
+
Note:  this process may change in the future; see [https://gitlab.com/librespacefoundation/satnogs/satnogs-db/issues?milestone_title=Improved+User+Experience the Gitlab issues list] for details.
  
 
===Coding===
 
===Coding===
Fluent in Python and/or JS? We need you to help with satnogs-db web application. Take a look to our [https://github.com/satnogs/satnogs-db source code] or visit our [https://github.com/satnogs/satnogs-db/issues issues tracker] to start filling bugs, feature requests or code fixes for existing ones.
+
Fluent in Python and/or JS? We need you to help with the satnogs-db web application! Take a look at our [https://gitlab.com/librespacefoundation/satnogs/satnogs-db source code], or visit our [https://gitlab.com/librespacefoundation/satnogs/satnogs-db/issues? issues tracker] to start filling bugs, feature requests or code fixes for existing ones.
 +
 
 +
==API==
 +
 
 +
The SatNOGS DB API is available to anyone at https://db.satnogs.org/api/
 +
More docs to come....
 +
 
 +
==Documentation & Installation==
 +
 
 +
You can find documentation and installation instructions about the project in our [https://docs.satnogs.org/projects/satnogs-db/en/stable/ Read the Docs instance].
 +
 
 +
== See also ==
 +
* [[SatNOGS Network]]
 +
* [https://libre.space/2020/03/02/space-situational-awareness/ Space Situational Awareness – The story so far and an open way forward]
  
===[http://docs.satnogs.org/db/contribute.html How to contribute]===
+
[[Category:Infrastructure]]
 +
[[Category:Operate]]
 +
[[Category:Satellite]]
 +
[[Category:RF Modes]]

Revision as of 00:57, 3 March 2020


Introduction

SatNOGS DB is an effort to create a holistic, unified, global transmitter database for all satellite transmitters. You can export the data or even connect your application using our API. It's part of the SatNOGS project.

SatNOGS DB Screen capture

Data

The DB is open to everyone. Anyone is able to submit suggestions or use the existing Transmitters. All data are public and freely under the Creative Commons Atribution-Share Alike license.

Contribute

Adding Satellites

If you are a moderator you can add new satellites on the DB. For that follow the instructions:

  1. Log in to db.satnogs.org
  2. Navigate to https://db.satnogs.org/admin (if you are seeing a login screen, you are either not logged in to db.satnogs.org, or don't have moderator permissions)
  3. Click on Base::Satellite Add button
  4. Complete the information to the best of your knowledge. Norad ID and Name are mandatory. Add multiple names on the "Names" field.
  5. Click Save and you are done!
  6. You can now move on to the next steps: suggesting and approving transmitters for this satellite.

Note: this process may change in the future; see the Gitlab issues list for details.

Suggesting transmitters

Db transmitter suggestion.png

We rely on crowd-sourced information to keep our transmitter details up to date. Anyone with a SatNOGS login can submit transmitter details. Moderators are notified and approve submissions frequently.

  • Description: This is the name that will appear for this transmitter across DB, Network, and API users. Please use the following notations
    • Band, for instance VHF, or for a transceiver, MODE U/V
    • Baud (if applicable), in the format 9k6 for 9600
    • Mode, for instance FSK
    • Rough type description, ie TLM for "telemetry", or "FM Transponder" for repeater
    • Examples
      • UHF 9k6 FSK TLM
      • MODE U/V FM Transceiver
      • VHF CW TLM
  • Status
    • Active: alive and well
    • Inactive: not functional or powered down
    • Invalid: this is a legacy transmitter that should be hidden from UI
  • Type
    • Transmitter: one-way downlink (telemetry)
    • Transceiver: repeats an uplinked signal intact
    • Transponder: interacts with an uplinked signal or downlinks after signal modification
  • Downlink: Published frequency, in Hz
  • Downlink Drifted: Observed frequency, or what frequency should be used to properly tune (with doppler correction). In most cases this should be the same as the Downlink frequency. This field must be entered even if there is no drift.
  • Mode: The modulation mode for this transmitter
  • Baud rate: the baud rate, if applicable. If this is a CW beacon, use WPM
  • Citation URL: a URL to link to in providing the details for your suggestion.


Approving transmitters

If you are a moderator you can approved suggestions for transmitters. For that follow the instructions:

  1. Log in to db.satnogs.org
  2. Navigate to https://db.satnogs.org/admin (if you are seeing a login screen, you are either not logged in to db.satnogs.org, or don't have moderator permissions)
  3. Click on Base::Suggestions
  4. Click on the suggestion you want to review and carefully check the data, especially the citation URL
  5. When you are ready to approve or reject the suggestion, go back to the full list of suggestions
  6. Select the suggestions you want to act upon and from the drop down above either approve them or reject them
  7. You are done!

Note: this process may change in the future; see the Gitlab issues list for details.

Coding

Fluent in Python and/or JS? We need you to help with the satnogs-db web application! Take a look at our source code, or visit our issues tracker to start filling bugs, feature requests or code fixes for existing ones.

API

The SatNOGS DB API is available to anyone at https://db.satnogs.org/api/ More docs to come....

Documentation & Installation

You can find documentation and installation instructions about the project in our Read the Docs instance.

See also