TkMidpoint is a program that calculates the midpoints of astrological charts. There are several functions that are related to midpoints and all of them will be introduced here step by step.
The program runs on Windows, Linux and Mac operating systems.
In order to run TkAstroDb, at least Python's 3.6 version must be installed on your computer. Note that in order to use Python on the command prompt, Python should be added to the PATH. There is no need to install manually the libraries that are used by the program. When the program first runs, the necessary libraries will be downloaded and installed automatically.
1. Run the program by writing the below command to the console window.
For Unix
python3 TkAstroDb.py
For Windows
python TkAstroDb.py
2. Below is the main window that is coming after the program opens.
3. As can be seen above, there are 4 menu cascades at the top of the program. Record is the first menu cascade which has two options that are Create and Open menu buttons.
4. By selecting Create menu button, the below window occurs.
5. As can be seen below, all the empty fields must be filled with the correct data in order to add a record to the database of the program. If any field is wrongly filled, the program will pop-up a Warning message.
6. After a record is added to the database, by selecting Open menu button, the records that is added to the program's database can be seen. The name of the database is records.csv and can be found in TkMidpoint directory.
7. The midpoint calculations are done by using this Open panel. If users select a record and if users right click to the selected record, a right click menu is occurred.
8. Users can edit or delete the existing records. If users click the Export cascade, the cascade is extended.
9. The first cascade which name is Midpoints has two options.
10. If users click Natal Midpoints button, the program calculates the natal midpoints of the selected record in less than a second. The results will be inserted in a spreadsheet file.
11. If users select Progressed Midpoint option, the program asks for a date of progression.
After writing a correct date, the midpoints of the progression are calculated in less than a second. The results will be inserted in a spreadsheet file.
12. The other menu cascade is about calculating the aspects between midpoints and planets. As can be seen below, there are 5 options that users can select.
13. Each option among this five produces two files. One file is a spreadsheet file that includes the record information, orb factors for each aspect, positions of midpoints that make aspects to planets, the planets that make aspect to the midpoints and the positions of that planets and also the orbs of the aspects. The second file is a text file that includes the interpretations that are valid for all these 5 options.
When users select options which are about Transits and Progressions, the program will ask the user to enter a date.
Regardless of the aspect type, the same interpretations are used for every midpoint and planet pair with an information about what the aspect type is.
Aspects between midpoint of natal planets and natal planets Interpretations of aspects between midpoint of natal planets and natal planets
Aspects between midpoint of natal planets and transit planets Interpretations of aspects between midpoint of natal planets and transit planets
Aspects between midpoint of natal planets and progressed planets Interpretations of aspects between midpoint of natal planets and progressed planets
Aspects between midpoint of transit planets and natal planets Interpretations of aspects between midpoint of transit planets and natal planets
Aspects between midpoint of progressed planets and natal planets Interpretations of aspects between midpoint of progressed planets and natal planets
14. The last menu button is for calculating the midpoints of the selected record and checks whether these midpoints are making an aspect to another record that is stored in the database. After clicked that, the records which are available in the records database are listed in a treeview except from the record that is selected previously.
15. The second menu cascade was named as Interpretations. If users click the View menu button which is under the Interpretations menu cascade, a window like below occurs.
16. By default, there's no available interpretation. There can be created totally 2754 possible interpretations for 18 objects. If users double click on an interpretation row, a panel like below occurs.
Users can write their own interpretations or they can copy and paste an interpretation and write the author of the text. If the text field remained empty and users click the Apply button, the availability status of the midpoint planet pair doesn't change. However if users write something to the text field, then if they press Apply button, the status of availability changes suddenly.
Users can also modify the text or author of the interpretations by double clicking the interpretation row. If the author field remains empty, it doesn't have an effect on the availability status of an interpretation. The more users add interpretations for the midpoint-planet pairs, the more the interpretation file will be filled. But by default, it's written None to the text section of the notepad file. The interpretations are stored in the interpretations.xml file which can be found in TkMidpoint directory.
17. The name of third menu cascade is Settings. This cascade has one menu button which is for changing the orb factors.
By default, the orb factors are defined as 1 degree. The valid unit is degree-minute-second. So users shouldn't delete the text field or shouldn't write a number such as 1.2. The program will pop-up a warning message when the field is wrongly filled. So when users want to specify the orb factor as +- 1.2 degree, the correct notation should be as 1° 2' 0".
18. The forth menu cascade includes two menu buttons which names are About and Check for updates. By clicking About menu button, users can see the contact information; and by clicking Check for updates menu button, users can update their scripts if any update is released.
TkMidpoint is released under the terms of the GNU GENERAL PUBLIC LICENSE. Please refer to the LICENSE file.