# Libre Sattools
Libre Sattools is a free software fork of Cees Bassa's `sattools`.

Current state: it works.

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

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


# Features
The `giza` branch is mostly similar to upstream, but with
`giza` instead of `pgplot`.

The following (mis?)-features have been added to `skymap` in the active
`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), last 30 days, Space Stations, Active Satellites,
  GNSS, and visual TLEs.

* Update SGP4 files to latest upstream.

* Add long options (e.g. `--help`) on the command line.

* A local version of bits of qfits is included, so no
  upstream install is required to build.
  (Are the binary apps needed elsewhere?)


# Install
In Debian: `libgiza0 giza-dev` etc.


# Usage
```
$ ./skymap --help
Usage: skymap [OPTION]
Visualize satellites on a map of the sky.

-t, --time    Date/time (yyyy-mm-ddThh:mm:ss.sss) [default: now]
-c, --catalog    TLE catalog file [default: satnogs.tle]
-i, --id    Satellite ID (NORAD) [default: all]
-R, --ra    R.A. [hh:mm:ss.sss]
-D, --decl    Decl. [+dd:mm:ss.ss]
-A, --azimuth    Azimuth (deg)
-E, --elevation    Elevation (deg)
-w, --width    Screen width
-g, --height    Screen height
-n, --nmax    nmax line resolution/speed (default 128)
-S, --all-night    All night
-Q, --no-stars    No stars
-a, --all-objects    Show all objects from catalog (default: LEO)
-h, --help    This help
-s, --site    Site (COSPAR)
-d, --iod    IOD observations
-l, --length    Trail length [default: 60s]
-P, --planar-id    planar search satellite ID
-r, --planar-alt    planar search altitude
-V, --visibility-alt    altitude for visibility contours
-p, --positions-file    File with xyz positions
-L, --longitude    manual site longitude (deg)
-B, --latitude    manual site latitude (deg)
-H, --elevation    manual site elevation (m)
```


# Port
Info about the port to free software `giza` instead of
proprietary and unmaintained `pgplot` can be seen in the `PORT.md` file.


# Upstream
See `README-upstream.md`.

Sattools, GPLv3.

* https://github.com/cbassa/sattools

Giza, GPLv2.

* https://danieljprice.github.io/giza

SGP4, LGPLv3:

* https://gitlab.com/pscrawford/dundee_sgp4/

qfits, libre permissive:

* ftp://ftp.eso.org/pub/qfits


# License
Same as upstream `sattools`, GPLv3.

*Copyright (C) 2022, Jeff Moe*