Difference between revisions of "SatNOGS DB"
From SatNOGS Wiki
(not a big enough page for a TOC) |
(→Introduction: Shrink front page image, improve data section, add link to CC-BY-SA license) (Tag: Visual edit) |
||
| (12 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | |||
| + | ==Introduction== | ||
| + | [[File:SatNOGS DB front page.png|alt=|400x400px|thumb|SatNOGS DB front page]][https://db.satnogs.org/ SatNOGS DB] is an effort to create a holistic, unified, global transmitter database for all satellite information. You can export the data or even connect your application using our API. It's part of the SatNOGS project. | ||
==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 | + | 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 [https://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 license] (CC-BY-SA-4.0). |
| + | |||
==Contribute== | ==Contribute== | ||
| − | === Adding Satellites === | + | ===Adding Satellites=== |
If you are a moderator you can add new satellites on the DB. For that follow the instructions: | 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) | + | #Log in to db.satnogs.org |
| − | # Click on Base::Satellite [https://db.satnogs.org/admin/base/satellite/add/ Add button] | + | #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) |
| − | # Complete the information to the best of your knowledge. | + | #Click on Base::Satellite [https://db.satnogs.org/admin/base/satellite/add/ Add button] |
| − | # Click Save and you are done! | + | #Complete the information to the best of your knowledge. NORAD ID and Name are mandatory. Add multiple names on the "Names" field. |
| − | # You can now move on to the next steps: suggesting and approving transmitters for this satellite. | + | #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. | 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 === | + | ===Suggesting transmitters=== |
| − | + | [[File:Create new transmitter.png|thumb|Menu item to add new transmitter suggestion (for logged in users)]] | |
| + | [[File:Transmitter suggestion.png|alt=|thumb|New transmitter suggestion (any logged in user can do it!)]] | ||
| + | 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. | ||
| + | |||
| + | Navigate to the satellite you want to edit or suggest a new transmitter and click on the Edit menu while logged-in.<br /> | ||
| − | === Approving transmitters === | + | *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 | ||
| + | *Type | ||
| + | **Transmitter: one-way downlink (telemetry) | ||
| + | **Transceiver: repeats an uplinked signal intact | ||
| + | **Transponder: interacts with an uplinked signal or downlinks after signal modification | ||
| + | *Status | ||
| + | **Active: alive and well | ||
| + | **Inactive: not functional or powered down | ||
| + | **Invalid: this is a legacy or erroneous transmitter information that should be hidden from UI | ||
| + | *Downlink Freq: 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. | ||
| + | *Downlink 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. Include observations from SatNOGS Network and/or frequency coordination documentation. | ||
| + | *Service: The ITU service that the transmitter can be categorized. | ||
| + | |||
| + | ===Approving transmitters=== | ||
| + | [[File:Review transmitter suggestion.png|thumb|Review transmitter suggestion (for moderators only)]] | ||
If you are a moderator you can approved suggestions for transmitters. For that follow the instructions: | If you are a moderator you can approved suggestions for transmitters. For that follow the instructions: | ||
| − | # Log in to db.satnogs.org | + | |
| − | # Navigate to | + | #Log in to db.satnogs.org |
| − | # | + | #Navigate to the satellite page that has pending suggestions for transmitters |
| − | + | #Review the suggestion | |
| − | # | + | #Decide to accept or reject it by clicking on the transmitter menu top right. |
| − | |||
| − | |||
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. | 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. | ||
| Line 36: | Line 66: | ||
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. | 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 == | + | ==API== |
| + | |||
| + | More info can be found in [[SatNOGS DB/API|API wiki page]]. | ||
| + | |||
| + | ==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] | ||
| − | + | [[Category:Infrastructure]] | |
| + | [[Category:Operate]] | ||
| + | [[Category:Satellite]] | ||
| + | [[Category:RF Modes]] | ||
Latest revision as of 21:02, 2 September 2021
Introduction
SatNOGS DB is an effort to create a holistic, unified, global transmitter database for all satellite information. You can export the data or even connect your application using our API. It's part of the SatNOGS project.
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 Attribution-ShareAlike 4.0 license (CC-BY-SA-4.0).
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 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 the Gitlab issues list for details.
Suggesting transmitters
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.
Navigate to the satellite you want to edit or suggest a new transmitter and click on the Edit menu while logged-in.
- 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
- Type
- Transmitter: one-way downlink (telemetry)
- Transceiver: repeats an uplinked signal intact
- Transponder: interacts with an uplinked signal or downlinks after signal modification
- Status
- Active: alive and well
- Inactive: not functional or powered down
- Invalid: this is a legacy or erroneous transmitter information that should be hidden from UI
- Downlink Freq: 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.
- Downlink 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. Include observations from SatNOGS Network and/or frequency coordination documentation.
- Service: The ITU service that the transmitter can be categorized.
Approving transmitters
If you are a moderator you can approved suggestions for transmitters. For that follow the instructions:
- Log in to db.satnogs.org
- Navigate to the satellite page that has pending suggestions for transmitters
- Review the suggestion
- Decide to accept or reject it by clicking on the transmitter menu top right.
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
More info can be found in API wiki page.
Documentation & Installation
You can find documentation and installation instructions about the project in our Read the Docs instance.
