2022-07-30 23:26:37 -06:00
|
|
|
# Giza Sattools
|
2022-07-31 17:34:30 -06:00
|
|
|
Current state: it works.
|
2022-07-30 23:26:37 -06:00
|
|
|
|
2022-07-31 16:48:35 -06:00
|
|
|
![skymap-giza rev 19](img/skymap-giza-19.png)
|
2022-07-30 23:26:37 -06:00
|
|
|
|
2022-07-31 17:34:30 -06:00
|
|
|
See above screenshot from port of `skymap`.
|
|
|
|
|
|
|
|
![satmap-giza rev 3](img/satmap-giza-3.png)
|
|
|
|
|
|
|
|
See above screenshot from port of `satmap`.
|
|
|
|
|
|
|
|
![satorbit-giza rev 3](img/satorbit-giza-3.png)
|
|
|
|
|
|
|
|
See above screenshot from port of `satorbit`.
|
2022-07-30 23:26:37 -06:00
|
|
|
|
|
|
|
|
2022-07-26 23:57:50 -06:00
|
|
|
# sattools
|
|
|
|
This is a fork of cbassa's sattools to try to get it to work with
|
|
|
|
free software giza instead of proprietary and unmaintained pgplot.
|
|
|
|
|
2022-07-27 00:14:26 -06:00
|
|
|
|
2022-07-27 00:04:42 -06:00
|
|
|
# Install
|
2022-07-28 10:53:19 -06:00
|
|
|
In Debian: `libgiza0 giza-dev` etc.
|
2022-07-27 00:14:26 -06:00
|
|
|
|
|
|
|
|
|
|
|
# Giza
|
2022-07-28 10:53:19 -06:00
|
|
|
Here are two examples of how `skymap` should render, in this case using
|
|
|
|
`pgplot` (thx Pierros and Cees):
|
2022-07-27 00:14:26 -06:00
|
|
|
|
2022-07-28 10:53:19 -06:00
|
|
|
![skymap-pgplot-pierros](img/skymap-pgplot-pierros.png)
|
|
|
|
|
|
|
|
![skymap-pgplot-cees](img/skymap-pgplot-cees.png)
|
2022-07-27 00:14:26 -06:00
|
|
|
|
|
|
|
This is how `skymap` renders "out-of-the-box" using `giza` as a
|
|
|
|
drop-in replacement for `pgplot`:
|
|
|
|
|
|
|
|
![skymap-giza rev 0](img/skymap-giza-0.png)
|
|
|
|
|
2022-07-27 00:34:31 -06:00
|
|
|
Stars fix:
|
2022-07-27 00:20:33 -06:00
|
|
|
|
|
|
|
![skymap-giza rev 1](img/skymap-giza-1.png)
|
|
|
|
|
2022-07-27 00:34:31 -06:00
|
|
|
Text fix:
|
2022-07-27 00:33:50 -06:00
|
|
|
|
|
|
|
![skymap-giza rev 2](img/skymap-giza-2.png)
|
|
|
|
|
2022-07-27 01:17:01 -06:00
|
|
|
Rectangle fix, and grey:
|
2022-07-27 00:51:45 -06:00
|
|
|
|
2022-07-27 01:17:01 -06:00
|
|
|
![skymap-giza rev 4](img/skymap-giza-4.png)
|
2022-07-27 00:51:45 -06:00
|
|
|
|
2022-07-27 02:16:51 -06:00
|
|
|
More `pgplot` colors.
|
2022-07-27 02:17:17 -06:00
|
|
|
|
2022-07-27 02:16:51 -06:00
|
|
|
![skymap-giza rev 5](img/skymap-giza-5.png)
|
|
|
|
|
2022-07-27 02:47:06 -06:00
|
|
|
Giza sizing needs fixing...
|
2022-07-27 02:48:41 -06:00
|
|
|
|
2022-07-27 02:47:06 -06:00
|
|
|
![skymap-giza rev 6](img/skymap-giza-6.png)
|
|
|
|
|
2022-07-27 03:49:36 -06:00
|
|
|
SatNOGS TLE loads and renders.
|
|
|
|
|
|
|
|
![skymap-giza rev 7](img/skymap-giza-7.png)
|
|
|
|
|
2022-07-27 22:38:00 -06:00
|
|
|
There is an error that spams out to the console:
|
|
|
|
|
|
|
|
```
|
|
|
|
%giza - Warning - giza_set_character_height: Invalid character height, character height not set
|
|
|
|
```
|
|
|
|
|
|
|
|
The character heights are set to various values, typically `0.6`, `0.8`, and
|
|
|
|
`1.0`. Only `1.0` doesn't produce the error. But it renders much larger...
|
|
|
|
This has no errors, but looks bad. Overall need new font.
|
|
|
|
|
|
|
|
![skymap-giza rev 8](img/skymap-giza-8.png)
|
2022-07-27 02:47:06 -06:00
|
|
|
|
2022-07-27 23:15:30 -06:00
|
|
|
Satellite orbit lines rendering.
|
|
|
|
|
|
|
|
![skymap-giza rev 9](img/skymap-giza-9.png)
|
|
|
|
|
2022-07-27 23:38:35 -06:00
|
|
|
More, but not rendering so great...
|
|
|
|
|
2022-07-27 23:41:29 -06:00
|
|
|
![skymap-giza rev 11](img/skymap-giza-11.png)
|
2022-07-27 23:15:30 -06:00
|
|
|
|
2022-07-28 00:02:44 -06:00
|
|
|
Grid, but rendering with dots, not lines...
|
|
|
|
|
|
|
|
![skymap-giza rev 12](img/skymap-giza-12.png)
|
|
|
|
|
2022-07-28 12:35:26 -06:00
|
|
|
Rest of grid (blue background during day).
|
2022-07-28 10:42:49 -06:00
|
|
|
|
|
|
|
![skymap-giza rev 13](img/skymap-giza-13.png)
|
|
|
|
|
2022-07-28 11:55:59 -06:00
|
|
|
Equatorial. Hit `o` when `skymap` first launches, then it will re-render
|
|
|
|
with a faint equatorial "dot line circle"...
|
|
|
|
|
|
|
|
![skymap-giza rev 14](img/skymap-giza-14.png)
|
2022-07-27 23:15:30 -06:00
|
|
|
|
2022-07-28 12:35:26 -06:00
|
|
|
Remove broken constellations looks better for now.
|
|
|
|
|
|
|
|
![skymap-giza rev 15](img/skymap-giza-15.png)
|
|
|
|
|
2022-07-30 21:55:43 -06:00
|
|
|
fix orbit lines, maybe correct. need to confirm against main version.
|
2022-07-30 20:33:43 -06:00
|
|
|
|
|
|
|
![skymap-giza rev 16](img/skymap-giza-16.png)
|
2022-07-28 12:35:26 -06:00
|
|
|
|
2022-07-31 16:48:35 -06:00
|
|
|
Revert back to original size. Full size now, see top of page.
|
2022-07-30 21:55:43 -06:00
|
|
|
|
|
|
|
![skymap-giza rev 17](img/skymap-giza-17.png)
|
|
|
|
|
|
|
|
|
2022-07-27 00:44:08 -06:00
|
|
|
# Works
|
2022-07-27 04:17:55 -06:00
|
|
|
Testing/dev in Debian Bookworm (testing), with `giza` version `1.3.2`.
|
|
|
|
|
2022-07-28 00:02:44 -06:00
|
|
|
Out of box, this works:
|
2022-07-27 00:44:08 -06:00
|
|
|
* Sun.
|
|
|
|
* Moon.
|
2022-07-27 03:33:26 -06:00
|
|
|
* Besides the display, all the other functionality works.
|
2022-07-27 03:34:07 -06:00
|
|
|
Can load a `satnogs.tle`, get satellite info, schedule, etc.
|
2022-07-27 00:44:08 -06:00
|
|
|
|
|
|
|
|
|
|
|
# Fixed
|
2022-07-31 17:34:30 -06:00
|
|
|
`skymap`, `satmap`, and `satorbit` have been ported.
|
|
|
|
|
2022-07-27 00:44:08 -06:00
|
|
|
* Stars.
|
|
|
|
* Text header with date, observer, lat/lon/elevation.
|
|
|
|
* Footer with R, D etc.
|
2022-07-27 00:51:45 -06:00
|
|
|
* Rectangle.
|
2022-08-03 17:09:39 -06:00
|
|
|
* Apex renders.
|
|
|
|
* Grid renders.
|
2022-07-27 02:56:06 -06:00
|
|
|
* Satellites' colors.
|
2022-07-27 23:15:30 -06:00
|
|
|
* Orbit lines.
|
2022-07-30 21:17:58 -06:00
|
|
|
* FOV (but disabled by default upstream).
|
2022-07-31 17:34:30 -06:00
|
|
|
* Lines are dots not lines.
|
|
|
|
* Small window size with giza in `skymap` and `satmap`.
|
2022-08-03 17:09:39 -06:00
|
|
|
* Small window size with giza in `satorbit`.
|
|
|
|
* Font. OK now.
|
2022-08-06 15:25:59 -06:00
|
|
|
* Constellations.
|
|
|
|
* Some speed ups.
|
|
|
|
|
|
|
|
|
|
|
|
# Features
|
|
|
|
The following (mis?)-features have been added to the `spacecruft` branch:
|
|
|
|
|
|
|
|
* Optionally resize window on command line with `--width` and `--height`.
|
|
|
|
(Probably best to just get width and calculate a good height.)
|
|
|
|
|
|
|
|
* Optionally change resolution of drawing lines with `--nmax`.
|
|
|
|
(Probably best to calculate nmax depending on window size.)
|
|
|
|
|
|
|
|
* Add SatNOGS (now default) and `visible` TLEs.
|
|
|
|
|
|
|
|
* Update SGDP4 files to latest upstream.
|
2022-07-27 00:44:08 -06:00
|
|
|
|
2022-08-06 16:10:24 -06:00
|
|
|
* Add long options (e.g. `--help`) on the command line.
|
|
|
|
|
2022-07-27 00:44:08 -06:00
|
|
|
|
|
|
|
# TODO
|
2022-07-31 17:34:30 -06:00
|
|
|
* Slow.
|
2022-07-27 03:05:20 -06:00
|
|
|
|
2022-07-27 00:44:08 -06:00
|
|
|
|
2022-07-30 21:47:56 -06:00
|
|
|
# Functions
|
|
|
|
These are `pgplot` functions used by `skymap`.
|
|
|
|
|
|
|
|
```
|
|
|
|
cpgbox
|
|
|
|
cpgcirc
|
|
|
|
cpgconl
|
|
|
|
cpgcont
|
|
|
|
cpgcurs
|
|
|
|
cpgdraw
|
|
|
|
cpgend
|
|
|
|
cpgeras
|
|
|
|
cpgmove
|
|
|
|
cpgmtxt
|
|
|
|
cpgopen
|
|
|
|
cpgpap
|
|
|
|
cpgpt1
|
|
|
|
cpgqch
|
|
|
|
cpgqci
|
|
|
|
cpgqls
|
|
|
|
cpgrect
|
|
|
|
cpgsch
|
|
|
|
cpgsci
|
|
|
|
cpgscr
|
|
|
|
cpgsfs
|
|
|
|
cpgsls
|
|
|
|
cpgslw
|
|
|
|
cpgsvp
|
|
|
|
cpgtext
|
|
|
|
cpgwnad
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2022-07-27 02:58:14 -06:00
|
|
|
# Color
|
2022-07-27 01:42:20 -06:00
|
|
|
Colors 1-15 are used in the color index, documented here:
|
|
|
|
|
|
|
|
* https://sites.astro.caltech.edu/~tjp/pgplot/fig51.html
|
|
|
|
|
2022-07-27 02:58:14 -06:00
|
|
|
Colors are off because giza uses it's own palette by default.
|
|
|
|
What is needed is to add `giza.h` and set this to use pgplot colors:
|
2022-07-27 02:12:47 -06:00
|
|
|
|
|
|
|
```
|
|
|
|
giza_set_colour_palette(1);
|
|
|
|
```
|
|
|
|
|
2022-07-31 17:21:55 -06:00
|
|
|
|
2022-07-31 12:00:51 -06:00
|
|
|
# Satorbit
|
2022-07-31 12:31:13 -06:00
|
|
|
`satorbit` has the same issues as `skymap`.
|
2022-07-31 12:00:51 -06:00
|
|
|
|
|
|
|
Here is what it looks like out-of-the-box with Giza:
|
|
|
|
|
|
|
|
![satorbit-giza rev 1](img/satorbit-giza-1.png)
|
|
|
|
|
2022-07-31 12:10:12 -06:00
|
|
|
Fixes to colors, and "lines" drawn as dots:
|
|
|
|
|
|
|
|
![satorbit-giza rev 2](img/satorbit-giza-2.png)
|
|
|
|
|
2022-07-31 17:34:30 -06:00
|
|
|
Latest at top of page.
|
2022-07-31 17:21:55 -06:00
|
|
|
|
2022-07-27 23:15:30 -06:00
|
|
|
|
2022-07-31 12:31:13 -06:00
|
|
|
# Satmap
|
|
|
|
`satmap` has the same issues as `skymap`.
|
|
|
|
|
|
|
|
Here is what it looks like out-of-the-box with Giza:
|
|
|
|
|
|
|
|
![satmap-giza rev 1](img/satmap-giza-1.png)
|
|
|
|
|
2022-07-31 12:39:48 -06:00
|
|
|
Fixes for color, screensize, and dots for lines...
|
2022-07-31 17:34:30 -06:00
|
|
|
Latest fix at top.
|
2022-07-31 12:39:48 -06:00
|
|
|
|
|
|
|
![satmap-giza rev 2](img/satmap-giza-2.png)
|
|
|
|
|
2022-07-31 12:31:13 -06:00
|
|
|
|
2022-07-26 23:57:50 -06:00
|
|
|
# Upstream
|
|
|
|
See `README-upstream.md`.
|
2022-07-27 02:19:54 -06:00
|
|
|
|
2022-07-31 11:58:26 -06:00
|
|
|
Sattools:
|
|
|
|
|
|
|
|
* https://github.com/cbassa/sattools
|
|
|
|
|
|
|
|
Giza:
|
|
|
|
|
|
|
|
* https://danieljprice.github.io/giza
|
2022-07-27 02:19:54 -06:00
|
|
|
|
2022-08-06 12:23:37 -06:00
|
|
|
SGP4:
|
|
|
|
|
|
|
|
* https://gitlab.com/pscrawford/dundee_sgp4/
|
|
|
|
|
2022-07-27 02:19:54 -06:00
|
|
|
# License
|
|
|
|
Same as upstream license, GPLv3.
|
|
|
|
|
|
|
|
*Copyright (C) 2022, Jeff Moe*
|