sattools/README.md

# 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` etc.


# Giza
This is a sample how `skymap` should render, in this case using
`pgplot` (thx pierros):

![skymap-pgplot](img/skymap-pgplot.png)

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)


Stars fix:

![skymap-giza rev 1](img/skymap-giza-1.png)

Text fix:

![skymap-giza rev 2](img/skymap-giza-2.png)

Rectangle fix, and grey:

![skymap-giza rev 4](img/skymap-giza-4.png)

More `pgplot` colors.

![skymap-giza rev 5](img/skymap-giza-5.png)

Giza sizing needs fixing...

![skymap-giza rev 6](img/skymap-giza-6.png)


# Works
* Sun.
* Moon.


# Fixed
* Stars.
* Text header with date, observer, lat/lon/elevation.
* Footer with R, D etc.
* Rectangle.
* Apex ?
* Satellites' colors.


# TODO
* Orbit lines.
* Grid.
* Constellations only partially rendered.
* Small window size with giza.

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

* https://sites.astro.caltech.edu/~tjp/pgplot/fig51.html

What is really 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*