AstroNavi
Development will continue December 2023 to March 2024.
README
One point at the beginning: All of this looks very complicated but it isn't. You can solve the Astronavigational Problem simple up to as complex as possible. It depends on your sighting and requirements. If you are at open water than it's probably not required to know your position exactly. If you are nearby shallow water or a reef it probably matters. However this method give you the chance to have a very fast calculation using just basic arithmetic and also much more complex spheric geometry. But look at the Excel. Even someone having no clue of spheric geometry can use the template to do all of the math. Print the spreadsheet and go on. This software is designed to check humans calculations.
Version History Log:
| Date | Time | Author | Comments |
|---|---|---|---|
| 20230220 | 16:53 GMT | RN | Latest release uploaded. Some fixes related to character size to support as much as possible devices. |
| 20230222 | 18:32 GMT | RN | Added a printable Sight Reduction Form (SRF) to the app (at my mobile using Epson printer it works wired. It's required to repeat steps example->calc->SRF a few times. Debugging says "errors" in external classes. |
| 20230223 | 09:28 GMT | RN | Try to fix issues with SRF printing. Sometimes app crashes or there seams to be a bufferoverflow failure or something I know from programming in C/C++. Behaves like a missing or false/NULL pointer because it seems that the printer function can override the shared memory and than many strange things happen. It's pure JAVA. Done a lot in JAVA but never seen an application which behaves unpredictable. Seems to work now. |
| 20230223 | 13:30 GMT | RN | The reason for most of the problems related to Sight Reduction Form printing are special design of Android mobiles. "Debug Message: The application may be doing too much work on its main thread". Well, I removed one ressource not really necessary from the Simple Navigation dialog. The recommendation to realy solve this issue is not to have complex calculations in main thread. Well. What's this application calculating without any user action? Nothing. Poor Android Design. My opinion. If you have issues with that buy faster mobile phone. I do not see reasons in my code for this. It's just the way it work. Repeat Printing until you got it on paper. |
| 20230224 | 12:00 GMT | RN | Some minor changes. Added the image at the start dialog but from a different source directory and lesser size to avoid "The application may be doing too much work on its main thread" This seem to solve this issue. In my opinion an Android Studio issue. They offer the complete code behind the scene than they should deal with this stuff and for example forbid to large images or images placed in the false "res directory". |
| 20230225 | 10:00 GMT | RN | Some minor changes related to colors. Removed "force white background". Some users/tester had false default color theme at their mobiles and thought that my application had a poor color scheme. (Black background and white chars). If a user don't see the colors of the examples setup of his device is the reason. |
| 20230225 | 16:00 GMT | RN | Added a simple "help" feature. Documentation to the app. I started to show a PDF but this did not work as expected. Now it's a test on how to use assets and HTML inside an app. This do not work the way expected. A JEditorPane in Swing is much more powerful. |
| 20230228 | 19:00 GMT | RN | Added first step to calculate GHA, SHA and DECLINATION for the stars. Not Planets, Moon and Sun. If a user press PREV or NEXT in "Nautical Almanac" dialog than GHA, SHA and DECLINATION is calculated. I have to add a key listener also for Date and Time Observed to calculate these figures. However this most difficult thing seems to work so far more or less good. The SHA and DECLINATION is up to now not corrected. I will add required code tomorrow. |
| 20230228 | 23:40 GMT | RN | Added the key press events to Observed Time and Observed Date fields to update GHA while typing. Now a user can enter GHA Aries and GHA Aries+1 from Nautical Almanac or let the AstroNavigator calculate these figures The daily corrections are in progress. They do not work. Figures are good for 2023. If a user search for a star by using "PREV" and "NEXT" button the SHA and DECL the software will also compute these figures by itself. Corrrections are also in progress. These figures are good for 2023. |
| 20230301 | 06:00 GMT | RN | Checked the "correction" for SHA and DECLINATION. If you use the data calculated by this application than the failure seem to be nearby one or two nautical miles. Maybe I will add an improvement to the application to allow users to set the correcions for SHA und DECL by themself. Today I work on an algorithm which allow to calculate the corrections because it takes a lot of time. In my opinion this is required once every 50 years. |
| 20230302 | 07:00 GMT | RN | Minor bugfix related to form management and restart of the application. After restart of the application false CB names shown in "Nautical Almanac" dialog. This came from changes required to have the internal calculations of GHA, SHA and DECLINATION because the displayed names come from internal ARRAY and not from SharedPreferences anymore. I will have to change the whole code to reduce complexity of display management. However. It works now. |
| 20230303 | 00:00 GMT | RN | Added a dialog to allow a user to change GHA,GHAcor, DECLINATION, DECcorr for all of the Celestial Bodys to have as best as possible accuracy. |
| 20230304 | 11:11 GMT | RN | Some bug fixes applied and changes to the user interface to avoid unnecessary steps when going from and back to a dialog. This software must be as user friendly as possible. However, the code behind the scenes is wired. It's just rapid development and I started with the idea to solve a small problem and than it grew. |
| 20230304 | 13:16 GMT | RN | Shit happened. Previous release worked only in emulator and had massive problems at the real device. Sextant Correction crashed the app. Fixed this and a recalculation issue. |
| 20230306 | 16:00 GMT | RN | Added a dialog to have the calculation of the SUN's declination. I work an the PSA and SPA code to get better results. The current formula is nearby but it will be up to 1 or 2 degrees false. That's up to 220km! Inacceptable. However, it's a demo. I will solve this issue. Take some time. |
| 20230307 | 16:00 GMT | RN | Added some "fancy gizmos". A timer that refreshs the date and time in the "Celestial Body Correction" and the "Get declination of SUN" dialog. That's easy going and makes sense in this context. But in my opinion "fancy gizmo". However, I need some time for this Astro Math stuff. |
| 20230309 | 00:33 GMT | RN | Added another "fancy gizmo". Now the software show the Bearing and Elevation of the Sun if you are located in Greenwich. Next update this will use the calculated position in the Nautical Almanac dialog. |
| 20230310 | 12:00 GMT | RN | Added standard application behaviour (+ and - button) and persistence after closing a dialog to the "Get declination of SUN" dialog. |
| 20230310 | 17:29 GMT | RN | Fixed issues related to usage of TimeZone. The application was designed to work only with GMT and not with TimeZones. To add TZ made some trouble. |
| 20230310 | 21:00 GMT | RN | Fixed some minor bugs with DMS input to avoid crashes forced by false user input. It's also allowed now to have individual character size for all of the dialogs. |
| 20230311 | 21:00 GMT | RN | Calculating a proper declination. This value is much better than all of the ones calculated before. Not 100% those of the NA but nearby perfect. I will now work on the GHA problem. After that I will add as best as possible calculation. |
| 20230311 | 21:00 GMT | RN | Added a parser for DMS input. I want to force the users to enter valid data into the fields because there are some stupids which try decimal format and wonder about what happens. |
| 20230312 | 01:01 GMT | RN | DMS parser is working with some small faults. |
| 20230312 | 01:01 GMT | RN | DMS parser is working more or less perfect but one issue: If you enter a dot in degree...than shit happens. |
| 20230312 | 16:21 GMT | RN | DMS parser is working perfect. Now users are forced to enter valid DMS. |
| 20230312 | 21:57 GMT | RN | DMS parser is working perfect. Added DMS format check to all of the DMS inputfields. This seem to work good. Can not find any errors with this feature. |
| 20230313 | 10:43 GMT | RN | Removed "South" checkbox from Simple dialog and allow to push time and declination from SUN dialog to Simple dialog. |
| 20230313 | 10:43 GMT | RN | Fixed some bugs related to the deletion of the "South" checkbox. Shit happened. Now the software shows proper GHA Aries, GHA for the SUN and declination. Holy moly. "Kayshon, his eyes open." (more or less) |
| 20230314 | 09:44 GMT | RN | Changed some background colors. The computation of GHA Sun and Declination do not depend anymore on data calculated in "Simple Navigation (SUN)" dialog. Because this is a potential source of a lot of trouble. User expect data calculated for a given point in time as provided by Nautical Almanac and now it's always sure that only these figures are shown. |
| 20230315 | 21:14 GMT | RN | Changed some Background and TextColor changes in SUN calculation. Added calculation of DIP in Sextant calculation. Just enter Height above sealevel in meter than DIP is calculated much better as in Nautical Almanac. Prepared App. Altitude calculation for SUN, Stars and Planets. |
| 20230316 | 07:48 GMT | RN | Added refraction calculator. User can use the refraction calculation by Meeus or just the figures from the Nautical Almanac. |
| 20230316 | 17:48 GMT | RN | Added Tooltips to all of the input fields. Hope tha the tips will help someone. |
| 20230317 | 06:15 GMT | RN | Minor bug fix. Longitude at SUN dialog do not depend on TZ. |
| 20230317 | 13:54 GMT | RN | Major bug fix. TZ field in SUN dialog have now an impact on Declination, GHA Aries, GHA SUN, Bearing, Elevation and also the poor persons Longitude at the bottom. For me is this field a "visual" helper. I made a huge mistake because the emulator ran at GMT. This was the soure of some difficulties. |
| 20230323 | 16:12 GMT | RN | If the sun was nearby Equator but below the Equator from -000"00'00.1" to -000"59'59.9" than the software did not show a minus in front of the degrees. Fixed this. Now you can check why 20.03.2023 is start of spring and not 21.03.2023. Because the sun will move at 21:00 over the Equator. The failure in seconds for the declination is 000°00'9.00". In the Nautical Almanac your will find for 20.02.2023 a declination of 0°00.4' that's S000°00'24" and my software calculate -000°00'5.14". There is a small difference but in my opinion this do not really matter. It's almost nearby. A few "meters". |
| 20230401 | 11:58 GMT | RN | Name of the printable Sight Reduction Form in PDF Format is now "SRF_ |
# Valid DMS format
| No Sign | + | N | W | - | S | E |
|---|---|---|---|---|---|---|
| 359°59'59.99" | +179°59'59.99" | N89°59'59.99" | W179°59'59.99" | -179°59'59.99" | S89°59'59.99" | E179°59'59.99" |
| 359°59.99'00.59" | +179°59.99'00.59" | N89°59.99'00.59" | W179°59.99'00.59" | -179°59.99'00.59" | S89°59.99'00.59" | E179°59.99'00.59" |
| total 360° | total +180° | total N90° | total W180° | total -180° | total S90° | total E180° |
The DMS format algorithm checks that the decimal value of the input do not exceed the allowed total value for a field with given sign. That's why E179°59.99'00.59" is same as E179°59'59.99". Both is in decimal 180°. Allowed are two numbers (00.00-59.99) after the comma for minute and seconds. It should be impossible to enter a decimal value 123.123° and calc with this valid positions. The algorithm do not allow to delete ° or ' or ". It's required to have these always in the field to make it work.
MOST RECENT VERSION WILL BE FOUND IN THE MASTER BRANCH! The MAIN branch will be updated by me only after major changes.
This is a simple AstroNavigation utility. It's designed for Blue Water Sailors and Professionals using Nautical Almanac or Long Term Almanac plus a Watch, Sextant.
This App works on Android Mobile Phones like HUAWEI ATU-L21. That's my development platform. Maybe it will work on other devices but I was not able to check this. It was developed using Android Studio Version Electric Eel ( https://developer.android.com/studio/releases ).
This software come with no warranty. It's designed as best as possible. The given example of the Nautical Almanac 2022 is calculated correct. Small differences come from using up to 16 figures after the decimal point. The NA calculates with 5.
I use here math from different sources. I started with common sense math. The "Simple Navigation (SUN)" dialog is designed by common sense math. This tool is also good to show navigational problems of the 17'th and 18'th century. This tool is good for educational purpose, to show children at school the way acient navigators did it and why the invention of watches was required but that a watch and having perfect GMT is only one piece of a complex puzzle.
Download just "app-release.apk". I guess that your mobile will install it automatically. See: https://github.com/GeraldR63/AstroNavi/blob/master/app/release/app-release.apk for most recent.
This APP is under construction. Planned are to generate a complete "Sight Reduction Form" as required for a logbook plus a calculation without using a book like Nautical Almanac or Long Term Almanac (This is available since 17.March 2023). But that's bad practice. Computers help humans. We are not the slaves of computers. That's the major mistake younger people make by using computers. My software supports Navigators but the goal is not to make them stupids.
I attached also an ooCalc document which can also be used by Navigators. It's doing the same but shows each calculation step. It also contains an empty sheet with instructions how to calculate everything by yourself.
Process flow to get and calculate a position by classic Astronavigation. This computation is only valid if shot was taken exactly at the highest point of the Sun. Than the Sun ist 180° below or above your current position. This is the way it is calculated in the dialog "Simple Navigation (SUN)".
Example of very Simple Latitude Calculation: (This example is from an unknown source and not by me.)
| Situation | Basic | Basic | 21.08.1981 16:00GMT | 21.08.1981 16:30GMT |
|---|---|---|---|---|
| Height observed Ho | 75° | 43° | 85° | 55°37.8' |
| Zenith Distance (90°-Ho) | 15° | 47° | 5° | 34°22.2' |
| Declination of SUN | N10° | S10° | N12° | N11°59.6' |
| Latitude | N25° | N37° | N7° | N46°21.8' |
| Explanation | SUN above Equator but below vessels position |
SUN below Equator and below vessels position |
SUN above Equator and above vessels position |
SUN below Equator and below vessels position |
| Rules | Latitude= (90º – Ho) + declination (SAME) | Latitude= (90º – Ho) – declination (CONTRARY) | Latitude= declination – (90º – Ho) | Latitude= (90º – Ho) – declination (CONTRARY) |
Equipement an Astronavigator should own:
| Equipement | Almanac | Clock | Protractor | Paper I | Paper II |
|---|---|---|---|---|---|
| Starfinder 2102-D | Nautical Almanac The Crown | Mechanical Watch at GMT | Sextant | Sight Reduction Form | Universal Plotting Sheet |
| Kosmos-Sternkarte | Long Term Almanac Geoffrey Kolbe | Any watch at GMT | Simple Protractor | AstroNavigator App | AstroNavigator App |
New 20230306 Calculation of SUN's declination for "Simple" navigation. The image below shows all of the dialogs this app offer and the flow between them. The new dialog "Get declination of SUN" is available via "Simple Navigation (SUN)". This dialog do not offer high precesion. Precision seem to be at noon high and at midnight low. Compared the calculation with Nautical Almanac and for the tested days I had a difference of a few minutes which do not matter up to one degree and more. This matters. One degree is a huge failure. I'm working on a much better solution but now I have to use "Jean Meeus Astronomical Algorithms" to fix this. This will take a few days to get a working solution.
A word on the longitude. In this application you will find at "Simple Navigation (SUN)" a Longitude which is calculated old fashioned. The way ancient sailors did it. This is up to three degree false. By this figure the GHA in this dialog is calculated. Also with up to 3 degree failure.This failure comes from the SHA of the Sun. If you want to know the SHA of the Sun than you can compute this figure by yourself (See SUN dialog). If you press the SUN button than you will see in the bottom row also this "false" figure with orange background but the real longitude of the SUN for a given time is in "GHA SUN NA". GHA SUN NA shows where is realy High Noon for a given time! However, this is also a document of ancient art of navigation. The way they did it and the way humans learned. I started with common sense and the application ended with a high level of complexity. 20 years ago I asked "Bobby Schenk" for a simple way and there is a simple way but this is not really perfect. I expected the answer you find in the "Simple Navigation (SUN)" dialog because I was sure that the skipper in 17th, 18th, 19th century not calculated complex spherical geometry.