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

4.5 KiB
Raw Permalink Blame History

Sattools PGPlot Port

This is a fork of Cees Bassa's sattools to get it to work with free software giza instead of proprietary and unmaintained pgplot.

Giza

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

skymap-pgplot-pierros

skymap-pgplot-cbassa

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

Revert back to original size. Full size now, see top of page.

skymap-giza rev 17

More:

skymap-giza rev 18

skymap-giza rev 19

skymap-giza rev 20

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

skymap, satmap, and satorbit have been ported.

  • Stars.
  • Text header with date, observer, lat/lon/elevation.
  • Footer with R, D etc.
  • Rectangle.
  • Apex renders.
  • Grid renders.
  • Satellites' colors.
  • Orbit lines.
  • FOV (but disabled by default upstream).
  • Lines.
  • Small window size with giza in satorbit and satmap.
  • Constellations.
  • Some speed ups.
  • Font, sans serif, placement.

TODO

  • Slow.
  • Graves.

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

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);

Satorbit

satorbit has the same issues as skymap.

Here is what it looks like out-of-the-box with Giza:

satorbit-giza rev 1

Fixes to colors, and "lines" drawn as dots:

satorbit-giza rev 2

Latest at top of page.

Satmap

satmap has the same issues as skymap.

Here is what it looks like out-of-the-box with Giza:

satmap-giza rev 1

Fixes for color, screensize, and dots for lines...

satmap-giza rev 2

Satid

satid has the same issues as skymap.

Example satid 2022-08-09T20:39:54.823.fits.png using pgplot:

satid-pgplot-cbassa

Here is what it looks like out-of-the-box with Giza:

satid-giza rev 1

Fixes for color, screensize, and dots for lines...

satid-giza rev 2

Background and text colors.

satid-giza rev 3

License

GPLv3.

Copyright (C) 2022, Jeff Moe