spacecruft
/
sattools
1
0
Fork 0
Code Releases Activity
sattools/README.md

3.1 KiB
Raw Blame History

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.

Install

In Debian: libgiza0 giza-dev etc.

Giza

Here are two examples of how skymap should render, in this case using pgplot (thx Pierros and Cees):

skymap-pgplot-pierros

skymap-pgplot-cees

This is how skymap renders "out-of-the-box" using giza as a drop-in replacement for pgplot:

skymap-giza rev 0

Stars fix:

skymap-giza rev 1

Text fix:

skymap-giza rev 2

Rectangle fix, and grey:

skymap-giza rev 4

More pgplot colors.

skymap-giza rev 5

Giza sizing needs fixing...

skymap-giza rev 6

SatNOGS TLE loads and renders.

skymap-giza rev 7

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

Satellite orbit lines rendering.

skymap-giza rev 9

More, but not rendering so great...

skymap-giza rev 11

Grid, but rendering with dots, not lines...

skymap-giza rev 12

Rest of grid (blue background during day).

skymap-giza rev 13

Equatorial. Hit o when skymap first launches, then it will re-render with a faint equatorial "dot line circle"...

skymap-giza rev 14

Remove broken constellations looks better for now.

skymap-giza rev 15

Fix orbit lines, maybe correct. Need to confirm against main version.

skymap-giza rev 16

Works

Testing/dev in Debian Bookworm (testing), with giza version 1.3.2.

Out of box, this works:

  • Sun.
  • Moon.
  • Besides the display, all the other functionality works. Can load a satnogs.tle, get satellite info, schedule, etc.

Fixed

  • Stars.
  • Text header with date, observer, lat/lon/elevation.
  • Footer with R, D etc.
  • Rectangle.
  • Apex renders, but as dots not lines.
  • Grid renders, but as dots not lines.
  • Satellites' colors.
  • Orbit lines.

TODO

  • Grid is dots not lines.
  • Constellations only partially rendered.
  • Apex rendering needs adjusting.
  • FOV.
  • Small window size with giza.
  • Check license status of sgdp4.c and sgdp4h.h.
  • Font.

Color

Colors 1-15 are used in the color index, documented here:

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:

giza_set_colour_palette(1);

Upstream

See README-upstream.md.

License

Same as upstream license, GPLv3.

Copyright (C) 2022, Jeff Moe