Occult v4
Occultation Prediction Software
by David Herald
- What's New in Occult v4.0
- How to Obtain Occult v4.0
- Installation Instructions and Notes
- Updated Files for Existing 4.0 Users
- How to Update Occult v4.0
- Becoming Familiar with the Program
- Copyright Issues
- Version History
WHAT'S NEW IN OCCULT V4?
Occult 4 is a complete rewrite of the Occult program, using the language C# and the '.Net Framework'. This has resulted in a vast number of changes in detail. The items listed here are merely the more noteworthy:
- Improved functionality for predicting lunar occultation and grazes
- Improved functionality for predicting asteroid occultations
- Improved tools for recording and analysing lunar occultations and grazes
- Improved tools for recording and analysing asteroid occultations
- Direct linking with GoogleEarth for drawing occultation and eclipse paths
- Direct linking with GoogleSky for viewing star fields
- FTP downloads of important files - such as Astorb, Steve Preston's Future.dat file of current asteroid occultations, and the MPC file of comet orbits.
- Faster computation. The speed increase depends on many factors, but Occult v4 is generally at least twice as fast as Occult 3.6. The most significant speed increase is searching for asteroid occultations - which is over 10 times faster.
- Greater accuracy, through revision of the code, and use of improved data sources (DE413 planetary ephemeris, Chebychev polynomial series for many moons of Jupiter and Uranus)
- For web site owners, create HTML files of occultation and eclipse paths for GoogleMaps, and create feeds for OccultWatcher
- Eclipses and occultations and transits of the main satellites of Jupiter, Saturn, Uranus and Neptune (with the planet)
- Mutual eclipses and occultations of the main satellites of Jupiter, Saturn and Uranus
- A Magnitude Calculator to determine the magnitudes of the components of a double star from a light curve;
winOccult3 had several different site file formats. Occult4 uses a single format for sites. You can import site files you created in Occult 3, and convert them to the new format.
Finally, the new Occult will function with the NOMAD catalogue – a 96GB catalogue including stars to mag 20. A cut-down version of this catalogue, containing all stars to Mag 14.5 is available on DVD [4.2GB]. For anyone interested in generating their own predictions this catalogue is HIGHLY desirable, as all error information is included
HOW TO OBTAIN OCCULT v4.0
- Download the files shown below by right clicking on the filename and doing a "save as"
- Order the CD (all files), and have it mailed to you.
To order the CD, send $5 with your name and address to: W.Robinson, 515 W. Kump, Bonner Springs KS, 66012, USA. You can send check, money order, or cash. NOTE: Anyone outside the continental USA should send money order or some similar draft in the amount of $10. My bank will not handle Canadian or overseas personal checks due to the routing number. If you use PayPal, you can transfer funds to my account. Account name: webmaster@lunar-occultations.com
INSTALLATION INSTRUCTIONS AND NOTES
The following notes are intended to provide guidance for the installation issues, and an overview of the functionality and new features.
Occult v4 is a complete rewrite of Occult. The previous version was written in the language VisualBasic6. This new version has been written in the language C#, and runs in the Net framework.
Before you can run the new version, you must have the Net Framework V2 installed on your computer. You can download this from the Microsoft Download center here. Or do a Google Search for ‘Net Framework V2’ to get the download site from Microsoft. If you are running Vista, Net V2 is already on your computer. If you have been running OccultWatcher, you have the Net framework installed.
The files you need to download are (use right click on your mouse and do a "save as"):
- Setup.exe - 421k - [November 2007 release]
- occult4 installer.msi - 38.9M - v4.0.2.8 - [Dec 30,2007 release]
- These files install Occult 4 – apart from the next two large files. Place these files in the same directory, and then run Setup. The default installation path is ‘...\Program Files\Occult 4
- tycho2.zip - 62.8M
- This download is essential for asteroid occultations. Unzip this file into the ...\Occult 4\Resource Files directory. You do not need to download this file if you have the Tycho2 catalogue in your current installation of Occult3. Rather, when you first run the program, you can specify the location of your Occult3 directory in the Maintenance tab, User Settings button. Then from the Maintenance tab, click the Import files from Occult3 button, and from there copy the file into Occult4. [You can also copy the Goffin catalogue (if you have that installed) – but this is not needed.]
- de405_413.zip - 51.8M
- This download is not essential, but HIGHLY DESIRABLE. Unzip this file into the ...\Occult 4\Resource Files directory. It contains the latest JPL ephemerides for the planets. It is essential for any predictions involving Pluto. If your current installation of Occult has the file JPL DE405.dat, you can copy that file in the same way as copying the Tycho2 catalogue (above). However, if you have downloaded de405_413.zip, do not bother copying the JPL DE405.dat file.
When you first run the program, you will be taken to a page that displays a range of default settings. You can change the settings here at any time after Occult has been installed. However at this stage you should do the following:
- insert your site details in the box Site details – low precision;
- if you have a previous installation of winOccult, specify the Occult directory of that installation in the box Previous installation of Occult;
- insert your email address for the FTP anonymous password in the box FTP URL’s;
- indicate whether GoogleEarth is installed on your computer, in the GoogleEarth box;
You will then be taken to the main form of Occult, from which you can access all the functionality. Next time you run Occult, the program will open at this form - and at the tab last used.
UPDATED FILES FOR EXISTING 4.0 USERS
- 4.0.3 update - 1.8M - [13 Mar 08 release]
Download this file ONLY if you already have 4.0 installed
- Updated Resource Files - 2.7M - (13 Mar 2008 release)
Download this file ONLY if you already have 4.0 installed
- Updated Asteroid Observations - 400k - (07 Apr 08 release)
Download this file ONLY if you already have 4.0 installed
Occult 4 Help File - 900k (15 Apr 08 release)
Download this file if you have problems accessing the Help File in original download
HOW TO UPDATE OCCULT 4
Occult 4 is very easy to update to a new version. You simply replace certain files with
new files.
Updates are of two kinds:
- updates to the program files; and
- updates to certain data files
* Program file updates *
Updates to program files are contained in the file:
UpdateToOccult_xxxxx.zip - where the xxxxx will indicate the version number
The files to be updated are all located in the '...Program Files\Occult 4' directory:
- Occult.chm
- Occult.exe
- Occult.exe.config
- OccultUtilities.dll
- OccultUtilities.dll.config
[There also a file called Updates.txt, which gives a comprehensive list of the changes made]
To make the update:
- Move the above 5 files to another location (just in case....)
- Unzip the file into the 'Occult 4' directory
The program will now run as before, but with the updated program.
* Data updates *
Updates to data files are contained in the file:
UpdateResourceFiles_xxxxx.zip - where the xxxxx will indicate a version number
All data files to be updated are held in the directory:
'...Program Files\Occult 4\Resource Files'
Simply unzip the update file into the Resource Files directory, replacing existing files.
The most likely data files to be updated are:
- AsteroidObservations.dat, and .inx
- BinaryAsteroidElements.dat
which are subject to constant updating.
BECOMING FAMILIAR WITH THE PROGRAM
The Help file system includes a number of ‘first-time user’ topics. You are urged to work through these examples - to become familiar with how the program works, and the functions that are available.
COPYRIGHT ISSUES
Occult relies heavily on data that is freely available. Items such as various star catalogues and the planetary ephemerides have been developed by government funded agencies or grants. Occultation and graze observations have been contributed mainly by the efforts of amateur astronomers (or as I prefer to call them, unpaid astronomers) from around the world. This contribution needs to be recognized and acknowledged.
The philosophy behind my writing and maintaining Occult is to encourage useful observations of occultation phenomena, thereby increasing our knowledge of the world around us. Accordingly:
- Users of Occult are free to disseminate predictions or results generated by Occult in a non-commercial manner, provided it is in a context of encouraging (directly or indirectly) observations of occultation phenomena. All I ask is that wherever possible there is an acknowledgement that the data was generated by Occult.
- In circumstances where there is a desire to include Occult predictions or results in a commercial publication, you may do so provided (i) it is in a context of encouraging (directly or indirectly) observations of occultation phenomena, and (ii) it is a minor part of that publication (eg a one or two page column in a 50-page monthly magazine). The fact that the predictions or results were generated by Occult4 should be acknowledged.
- Where the success of a commercial publication is likely to be dependant upon the output from OCCULT, you do not have automatic permission to include Occult outputs in that publication. You will need to contact the author and seek written permission.
-
Where the output of Occult is displayed on GoogleEarth, GoogleSky or GoogleMaps, you will also need to comply with any copyright issues associated with those products.
For the record, I reserve all rights to the Source code and any decompilation thereof - but with IOTA being able to continue to maintain/improve the program on the same basis as above, when I am no longer in a position to do so.
Dave Herald
November 2007
VERSION HISTORY
| 13 Mar 08 |
v4.0.3.0 |
Summary of main changes since v4.0.2.13
The changes in this version of Occult, compared to the previous version, are mainly
bug fixes. The most notable fixes are:
- World map showing lunar occultation region - displayed time of conjunction corrected
- Printing graphic outputs - ensured better fit to paper
- Multi-site lunar occultation predictions - enabled a moon-map showing the star path for each site
- Corrected error in display of star details for lunar occultations - to ensure the details of the correct Occultation discovery star is displayed.
- A number of changes associated with the MPC reporting process and the PDS archiving
process.
- Ability to do a 1-click - generate and save the graphics for all asteroid occultations
Incorporation of site correction for polar motion.
Additionally, this revision includes an update of a number of files in the
Resource Files directory. The files that are updated are:
- Asteroid observations (incorporating the latest results)
- Lunar graze observations (incorporating the latest grazes)
- corrected files used for creating GoogleMap web sites
- updated file of binary asteroids
- two NEW files containing Earth Orientation Parameters.
|
| 28 Jan 08 |
v4.0.2.13 |
- For Autogenerated output (from Summary, or external access) size/magnitude-limit/star
catalogue used for the star chart are now set in the User Settings.
- PrePoint list of stars - the Prediction date is now included in the header.
- Form for editing User file of asteroid elements - boxes for importing Comets better
labelled. Allowed the form to be resized. Minor adjustment to Epoch Year box width.
- Search against Planets and Moons using Nomad - ensured the Nomad catalogue was
'released' if the search is cancelled.
- For search for asteroid or planet occultations, included a message at end to indicate
whether the search was completed, or cancelled.
|
Return to the
Main Index