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)


# Works
* Sun.
* Moon.


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


# TODO
* Satellites' colors.
* 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

With giza, it renders more like this:

```
0   Erase ?
1   Black
2   Orange
3   Forest green
4   Blue
5   Dark gray
6   Purple
7   Cyan
8   Orange
9   Grey green
10  Brown
11  Green
12  Dark blue
13  Red
14  Bright pink/red
15  Grey
16  Black
...
128 Grey
255 White
```


# Upstream
See `README-upstream.md`.