diff --git a/PORT.md b/PORT.md new file mode 100644 index 0000000..f256a21 --- /dev/null +++ b/PORT.md @@ -0,0 +1,195 @@ +# 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](img/skymap-pgplot-pierros.png) + +![skymap-pgplot-cees](img/skymap-pgplot-cees.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) + +SatNOGS TLE loads and renders. + +![skymap-giza rev 7](img/skymap-giza-7.png) + +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](img/skymap-giza-8.png) + +Satellite orbit lines rendering. + +![skymap-giza rev 9](img/skymap-giza-9.png) + +More, but not rendering so great... + +![skymap-giza rev 11](img/skymap-giza-11.png) + +Grid, but rendering with dots, not lines... + +![skymap-giza rev 12](img/skymap-giza-12.png) + +Rest of grid (blue background during day). + +![skymap-giza rev 13](img/skymap-giza-13.png) + +Equatorial. Hit `o` when `skymap` first launches, then it will re-render +with a faint equatorial "dot line circle"... + +![skymap-giza rev 14](img/skymap-giza-14.png) + +Remove broken constellations looks better for now. + +![skymap-giza rev 15](img/skymap-giza-15.png) + +fix orbit lines, maybe correct. need to confirm against main version. + +![skymap-giza rev 16](img/skymap-giza-16.png) + +Revert back to original size. Full size now, see top of page. + +![skymap-giza rev 17](img/skymap-giza-17.png) + + +# 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. + + +# TODO +* Slow. +* Graves. +* Font, sans serif, placement. + + +# 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: + +* https://sites.astro.caltech.edu/~tjp/pgplot/fig51.html + +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](img/satorbit-giza-1.png) + +Fixes to colors, and "lines" drawn as dots: + +![satorbit-giza rev 2](img/satorbit-giza-2.png) + +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](img/satmap-giza-1.png) + +Fixes for color, screensize, and dots for lines... +Latest fix at top. + +![satmap-giza rev 2](img/satmap-giza-2.png) + + diff --git a/README.md b/README.md index bedb299..03268ff 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,6 @@ -# sattools -This is a fork of Cees Bassa's `sattools` to get it to work with -free software `giza` instead of proprietary and unmaintained `pgplot`. +# Libre Sattools +Libre Sattools is a free software fork of Cees Bassa's `sattools`. - -# Giza Sattools Current state: it works. ![skymap-giza rev 20](img/skymap-giza-20.png) @@ -80,194 +77,10 @@ Visualize satellites on a map of the sky. -H, --elevation manual site elevation (m) ``` -# Giza -Here are two examples of how `skymap` should render, in this case using -`pgplot` (thx Pierros and Cees): -![skymap-pgplot-pierros](img/skymap-pgplot-pierros.png) - -![skymap-pgplot-cees](img/skymap-pgplot-cees.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) - -SatNOGS TLE loads and renders. - -![skymap-giza rev 7](img/skymap-giza-7.png) - -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](img/skymap-giza-8.png) - -Satellite orbit lines rendering. - -![skymap-giza rev 9](img/skymap-giza-9.png) - -More, but not rendering so great... - -![skymap-giza rev 11](img/skymap-giza-11.png) - -Grid, but rendering with dots, not lines... - -![skymap-giza rev 12](img/skymap-giza-12.png) - -Rest of grid (blue background during day). - -![skymap-giza rev 13](img/skymap-giza-13.png) - -Equatorial. Hit `o` when `skymap` first launches, then it will re-render -with a faint equatorial "dot line circle"... - -![skymap-giza rev 14](img/skymap-giza-14.png) - -Remove broken constellations looks better for now. - -![skymap-giza rev 15](img/skymap-giza-15.png) - -fix orbit lines, maybe correct. need to confirm against main version. - -![skymap-giza rev 16](img/skymap-giza-16.png) - -Revert back to original size. Full size now, see top of page. - -![skymap-giza rev 17](img/skymap-giza-17.png) - - -# 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. - - -# TODO -* Slow. -* Graves. -* Font, sans serif, placement. - - -# 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: - -* https://sites.astro.caltech.edu/~tjp/pgplot/fig51.html - -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](img/satorbit-giza-1.png) - -Fixes to colors, and "lines" drawn as dots: - -![satorbit-giza rev 2](img/satorbit-giza-2.png) - -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](img/satmap-giza-1.png) - -Fixes for color, screensize, and dots for lines... -Latest fix at top. - -![satmap-giza rev 2](img/satmap-giza-2.png) +# Port +Info about the port to free software `giza` instead of +proprietary and unmaintained `pgplot` can be seen in the `PORT.md` file. # Upstream