Differences

This shows you the differences between two versions of the page.

--- bigdish_console [2026/08/22 18:24] – [Satellite Tracking] dsheen
+++ bigdish_console [2026/08/22 19:19] (current) – [Tracking Offsets] dsheen
@@ Line 92: / Line 92: @@
 === Ephemeris Formats ===
-The file upload supports many different formats and coordinate systems. These currently include
+The ephemeris file upload supports many different formats and coordinate systems. These currently include
    * TLE as ''.tle'' or ''.txt'' (legacy, please stop using these)
    * OMM as ''.json'' or ''.csv''
-   * CCSDS OEM as ''.oem'' or ''.asc'' (the format Nasa used for Artemis II ephemeris)
+   * CCSDS OEM as ''.oem'' or ''.asc'' (the format NASA used for Artemis II ephemeris)
-   * Starlink modified ITC formay ''.txt'' (see: [[https://api.starlink.com/public-files/ephemerides/MANIFEST.txt]]
+   * Starlink modified ITC format ''.txt'' (see: [[https://api.starlink.com/public-files/ephemerides/MANIFEST.txt]], [[https://starlink.com/public-files/ephemerides/README.md]]) (TODO: need to test this one)
-==== Queued Antenna Commands ====
-==== Coordinate Queries ====
+==== Tracking Offsets ====
+The offsets tab in the sidebar allows setting an offset from a track in any of the three standard coordinate frames used by bigdish.
+Additionally, a fourth option is provided to offset by an angle defined in the frame of the target (parallel/perpendicular to track). This is defined as a right handed frame ordered as (pointing direction, travel direction, cross direction). Crucially, unlike the other frames, This frame gives a true angle of arc which is defined only by the commanded offsets independent of source position.
+==== Source Queries ====
+The [[#Utilities]] tab also has a search function for the [[https://simbad.u-strasbg.fr/simbad/|SIMBAD]] database. It should generally work for search terms like ''cas A'', ''M 87'', etc. I make no promises about the exact input formatting or reliability since that is dependent on them. Once a source is found it can be added to the tracking dialog.
+Note: this is very very slow. That is a problem with the database, not our queries.
+==== Queued Antenna Commands ====
+Uploading pre-plannned antenna trajectories is also supported in the same format used by [[https://github.com/w1xm/BigDishTools/blob/main/dish_client/WR66_run_pointing_file.py|WR66_run_pointing_file.py]]. Files should be .csv with columns containing
+<code>
+UTC_Time in ISO format, coordinate system, first coordinate, second coordinate, azvel [optional], elvel [optional]
+</code>
+The commands in any such file are added to a non-blocking queue (e.g. other commands can still be issued to the antenna until the timestamp of the first command in the file.