logo

Documentation
iPhemeris Astrology Software for iPhone & iPad

By Clifford Ribaudo
iPhemeris ® © 2008-2020 Clifford Ribaudo. All rights reserved.

iOS Introduction

What’s New iOS

Version 11.2.1

NOTE: Please update iPhemeris on all Apple devices to Version 4.2 on MacOS and Version 11.2.1 on iOS. Both are now available.

WHAT’S NEW

  • The Tropical / Sidereal settings is no longer global, and can be set differently for individual charts.
  • Heliocentric & Topocentric capabilities are included as part of the “Extended Ephemeris” In-App purchase.

TROPICAL / SIDEREAL SETTING – NOT GLOBAL

The major change in this release was the transition of the Sidereal setting to no longer being a global setting (the Ayanamsa setting is still global). This allows individual charts to be set to use Tropical, Sidereal, Geocentric, Topocentric or Heliocentric data. Topocentric and Heliocentric require the Extended Ephemeris In-App purchase, but if you already own it then this capability is now available on your iOS devices.

Briefly the way the new settings work is as follows:

  • In iPhemeris Settings – Ephemeris Section, there is a new button to set [Geocentric / Topocentric / Heliocentric].
  • There is also the previous button to set [Tropical / Sidereal].
  • Both buttons are now used as default values during horoscope creation, but these values can be changed when creating or editing any chart via similar buttons at the bottom of the Chart editor view.
  • The rest of the features in the iOS version of iPhemeris work as before and use the state of the buttons in settings to decide what type of data to display, Ephemeris Pages, Calendars and SkyNow and Houses Now.

HELIOCENTRIC AND TOPOCENTRIC

Heliocentric and Topocentric data is now available to owners of the Extended Ephemeris feature (see iPhemeris store). Existing owners of that In-App purchase will find it enabled in various places throughout the software.

ICLOUD DATA UPDATE & TRANSITION

This release of iPhemeris uses Apple’s newest CloudKit technology to store chart data to iCloud (at your option). In order to transition to this we had to copy data from the old iCloud location to the new iCloud location and also added support for the fact that astrological charts can now be Tropical, Sidereal, Topocentric or Heliocentric on an individual basis.

Therefore, during the copy of the data to the new iCloud location, we set astrological charts previously saved to be either Tropical or Sidereal based on whatever earlier global setting was found for your install. We hope that data is not duplicated but we did see it happening sometimes. Duplication is the lesser evil vs. losing data.

Please let us know via support@iphemeris.com if there are any issues and don’t forget to update all your devices to the latest version of iPhemeris.

TROUBLE SHOOTING DATABASE UPGRADE ISSUES

Unfortunately during the upgrade of the database, some people had been looking at Sidereal temporarily or had not understood the Sidereal / Tropical Setting in iPhemeris Settings. It was possible to have Sidereal set but with an Ayanamsa of “Tropical”. This would have meant that during the update of your chart database. We set this setting in each chart to Sidereal. If you notice that charts have unrecognizable position, check the area pointed to by the red arrow.

If it is Sidereal and should be Tropical or vice versa, this is easily remedied. Before using each chart for the first time (this is required only once) use the Chart Editor to set the chart to the correct value:

  1. Open the chart editor.
  2. Scroll to the bottom.
  3. Set the Tropical / Sidereal button to whichever you use. Most people want tropical.
  4. Make sure the Geocentric / Topocentric / Heliocentric button is set to Geocentric.

That chart is now back to normal and good to go. Unfortunately this will be required once and only once for each chart. We are sorry for the inconvenience but … stuff happens.

Also, please visit iPhemeris Settings and scroll to the Ephemeris section and double check that the value is what you want. Probably Tropical and Geocentric. Those values are now used as defaults for chart creation but can of course be changed with each chart from the Chart Editor as discussed above.

Top ▲

Introduction

iPhemeris uses the Swiss Ephemeris which is based on the Jet Propulsion Laboratories (JPL) DE431 ephemerides and the US Naval Observatory equivalent for Asteroids. It offers sub-second accuracy to with .001 seconds of arc.

If you’ve purchased the Extended Ephemeris (via In-App purchase) coverage is 7700 years (4700 BC to 2995 AD) otherwise coverage is 1700 to 2100. The data range applies to all iPhemeris features.

iPhemeris uses New StyleGregorian Calendar dates starting October 15, 1582 and Julian dates or Old Style prior. However, be aware that various locales adopted the Gregorian calendar at other times; for example, Great Britain didn’t switch until September 1752. Therefore, adjust your dates accordingly.

When using the Extended Ephemeris, enter new style dates after Oct. 15, 1582 and old style dates prior. Currently iPhemeris does not support proleptic Gregorian dates for dates prior to 1582.

Note:
We use translation services, but Astrology is a special discipline and many astrological terms have dual meanings. If you notice anything out of context or incorrect in your language please notify support.

Top ▲

iOS Settings

iOS Changing Tab Order

The order of iPhemeris feature Tabs (at the bottom) can be re-arranged via the More menu. The more menu is the right most tab with 3 dots:

  1. Tap the More button (far right).
  2. Tap the Edit button (upper right) to display the More Edit menu.
  3. Re-arrange Tabs by dragging them left or right.
  4. Drag a feature not on a tab from the list above onto the tab you want to assign it to.
  5. Tap the Done button to finish and save changes.

Functions which don’t fit onto the Tab Bar are always available on the More menu.

Top ▲

iOS Ephemeris Settings

Geocentric / Topocentric / Heliocentric

  • Used by all features to determine which type of data to display.
  • Charts/Horoscopes use this setting as the default during creation but it can be changed for individual Charts at anytime using a similar button at the bottom of the Chart editor view.
  • Topocentric and Heliocentric capabilities are enabled as part of the Extended Ephemeris In-App purchase.
  • Geocentric – most users should use this.
  • Topocentric – the view of the sky from the surface of the Earth at the exact location and elevation at that spot. Topocentric data requires elevation and iPhemeris will attempt to look it up from a NASA global elevation database after you set the location using the Map. This settings makes a very minor and inconsequential difference to the position of the moon for some charts at particularly high elevations (however people asked for it, so there ya go).
  • Heliocentric – the view of the heavens from the Sun. Some commodity markets traders like to use this.

Tropical / Sidereal:

  • Applies to most iPhemeris features. Charts use the value as a default but it can be changed for individual Horoscopes from the Chart editor.
  • Sidereal requires an Ayanamsa other than Tropical to be selected in order to notice any difference.

Ayanamsa:

  • This is a global setting and any feature displaying Sidereal data uses this setting.
  • Tap the Ayanamsa row to choose a pre-defined Ayanamsa and/or use your own value.
  • To set your own value choose Your Ayanamsa at the bottom of the ayanamsa list.
  • The degree offset from Tropical positions for pre-defined Ayanamsa are listed at the end of this documentation. Values shown are for Epoch Jan. 1 2000. iPhemeris adjusts that value to the date of the Chart or Table. It does this using the mean rate of annual precession (0.01396887831940 degrees per year).
  • Nakshatra Note: This setting is also used by the Nakshatra chart wheel style (see Chart Settings).

Using Your Own Ayanamsa:

  • Tap Ayanamsa row.
  • Scroll to the bottom of the ayanamsa list and select Your Ayanamsa.
  • Tap Settings button to save.
  • Tap the row titled Your Ayanamsa and enter your value for midnight Epoch Jan. 1 2000.
  • To calculate the correct value: ValueNow – ((CurrentYear – 2000) * 0.01396887831940).

Lunar Nodes, Black Moon (Lunar/apogee/Lilith): A global setting the determines if TRUE or MEAN value is used.

Precision: Toggle display of Ephemeris data between DD.MM.SS and DD.MM.

Time Zone:

  • Uses standard Time Zone notation. Locations East of Greenwich are positive (+) and West negative (-).
  • The Ephemeris does not automatically adjust for Summer/Winter time.
  • This Time Zone setting applies only to Ephemeris Displays and Calendars.

Hour: Sets the hour in the Time Zone for Ephemeris and Calendar displays. E.g. if the Ephemeris Time Zone is set for GMT (0) and Hour is set to 12:00, tables display Noon GMT positions.

 

Top ▲

iOS Display Settings

Set the color schemes used on tables and charts.

  • Ephemeris Colors: Choose a color scheme for Ephemeris Tables.
  • Calendar Colors: Choose a color scheme for Calendar Pages.
  • Graphic Ephemeris Colors: Choose a color scheme for the Graphic Ephemeris.
  • Chart Colors: Choose a color scheme for Charts.
  • Sky Now Color: Choose the color scheme used by Sky Now.

CUSTOM COLOR SCHEME

Users of the Mac version of iPhemeris can create a Custom Color Scheme for use with Charts and SkyNow from Mac iPhemeris Preferences. That color scheme will be saved to iCloud automatically and will be available for use by any iOS version of iPhemeris connected to iCloud.

To use your custom color scheme tap the Chart Colors or Sky Now Colors row and select the User Defined option at the bottom. It will only be enabled and selectable if your scheme has been saved and uploaded to the device.

Top ▲

iOS Planets & Chart Points

Select the Planets and other points (Asc, MC, etc.) displayed throughout the App for the various features:

  • Ephemeris: Select planets & points displayed on Ephemeris pages.
  • Graphic Ephemeris: Select planets & points displayed on the Graphic Ephemeris tab (also applies) the Graphic Ephemeris report in Chart reports.
  • Aspect Calendar: Select planets & points shown on Aspectarian Calendar.
  • Transit Calendar Chart (Radix): Select planets & points shown for Radix Chart on Transit Calendar.
  • Transit Calendar Sky: Select planets & points in sky used on Transit Calendar.
  • Charts: Select planets & points shown on Charts.
  • Sky Now: Select planets & points shown on Sky Now.
  • Pluto Symbol: Select your preferred symbol for Pluto.
  • Earth Symbol: Select your preferred symbol for Earth.
  • Eris Symbol: Select your preferred Eris symbol. Eris was discovered after the astrological community stopped assigning symbols to the multitude of planetoids being discovered. These are the two most frequently used.
  • Vulcan Symbol: Select your preferred symbol for the hypothetical planet Vulcan. Said by HP Blavatsky and Djwhal Khul (D.K.) to be inside the orbit of Mercury. It is possibly etheric and not dense physical.

Top ▲

iOS Chart Defaults

Chart defaults set preferences for how the Chart Wheel looks and also, to pre-populate some fields when creating new Charts.

House System – The default house system used on new charts.

Place – The default location set on new charts.

Use 24 Hour Time – Forces iPhemeris to always use 24 hour military style time regardless of locality settings (zero is midnight, 00:05 is 5 minutes after midnight).

Show Aspects On Wheel – Toggle ON/OFF display of aspect lines in the center of the wheel. This has no effect on reports.

Show House Number – Toggle ON/OFF display of house numbers on the wheel.

Label House Cusps:

  • OFF – Astrological Signs are displayed in the center of each zodiacal sign and degree marks are shown around the wheel. This gives the wheel a more European style.
  • ON – The point where the house cusp intercepts the sign is labeled in the outer wheel. This can mean that in some cases not every sign is labeled in the outer wheel (but every house cusp is).

Always Show Mc & Asc – Toggle ON/OFF display of Asc, Mc, Ic when those points are the same as one of the house cusps in the House system being used.

Show Minutes on Wheel – Toggle ON/OFF display of minutes on wheel. Minutes never display on tri-wheel.

French Wheel Style – When ON this causes the appearance of the horoscope wheel to display in a manner preferred in France. It has the effect of disabling some of the other settings in this section. This wheel style only works for single charts and will revert to other styles and settings for Bi and Tri-wheel.

Dotted Line for Separating Aspects – When ON dotted lines are drawn on the wheel for separating aspects and solid lines are used for applying. When OFF, solid lines are used for both applying and separating aspects and dotted lines are used for minor aspects.

Degree Marks on Wheel – Toggle ON/OFF the degree marks around outer edge of wheel.

Draw Bold Axis Cusps with Arrows – Draws bold arrows on wheel at ASC/DSC and MC/IC cusps.

Show Nakshatra – Toggle ON/OFF display of Vedic Nakshatra divisions (27) with the abbreviation for each. Nakshatra will use whatever Ayanamsa is selected in Ephemeris settings, so if you generally use Tropical charts, make sure you set an Ayanamsa in the Ephemeris section of iPhemeris settings.

Show Bounds/Terms – Will display the Traditional Astrology “Bounds” or “Terms” around the wheel with either the Egyptian or Ptolemaic rulers.

Decanates – Can be displayed around the edge of the chart wheel in one of 4 styles:

  1. Off – none at all.
  2. Empty – thin, gray, 10 degree segments.
  3. Modern – Decanates containing Modern rulers.
  4. Traditional – Decanates containing Traditional rulers.

Top ▲

iOS Progression Default Settings

iPhemeris currently provides the two most common Progression styles, more will be added in future.

PROGRESSION STYLES – PLANETS

  • Secondary Progressed – Standard 1 day for 1 year and fraction thereof, since the natal or radix date. All planets are shown in their position on the implied Secondary progressed date and time. You can verify this by counting how many years it has been since the birth year and then looking at the ephemeris page for the day which is the same number of days after the birth date.
  • Solar Arc in Longitude – All planets are moved the same number of degrees (in longitude) which the Sun moved as calculated by the Secondary Progression technique. Using this style of progression, planets can be in positions they never actually occupied (all together) in time and space.

PROGRESSION STYLES – CUSPS

  • Solar Arc in Longitude – The MC is progressed by the Sun’s Solar Arc in Longitude from the natal or radix date to the progressed date. The Ascendant and cusps are calculated from the progressed MC’s implied Right Ascension.
  • Solar Solar Arc Directed – MC, ASC and cusps are moved the same number of degrees in longitude the Sun moved, using the Secondary Progression technique.

Top ▲

Part of Fortune Settings

Choose the algorithm used to calculate Part of Fortune. Most ancient authorities advocated using a different algorithm for day and night births. However, due to an early mis-translation of Ptolemy’s writings, a common misconception has crept into modern Astrology causing people to think he advocated using the same formula for both. Recent translations make it clear that he did not. iPhemeris offers both.

CALCULATION

  • Day births – when the sun is above the ascendant/descendant line.
  • Night births – when the Sun is below the ascendant/descendant line.

Different for Day and Night (the default):

  • Day Birth:  Ascendant + Moon – Sun.
  • Night Birth:  Ascendant + Sun – Moon.

The Same for Day and Night: Ascendant + Moon – Sun.

Top ▲

iOS Orb Settings

Orbs can be individually set for each of the 4 Features that use them:

  • Charts
  • Sky Now
  • The Aspect Calendar
  • The Transit Calendar

SETTING ORBS

  1. Scroll down to the Orbs section in iPhemeris Settings.
  2. Tap the row of the feature you want to set orbs for.
  3. Charts and Sky Now have independent settings for Applying (A) and Separating (S), calendars use a single orb.
  4. Once in the features Orb settings view, tap the Edit button (upper right) and then tap the row for the aspect you want to change orbs for.
  5. Fractional values of 1/10th of a degree are supported.
  6. To turn an aspect OFF, set its orbs to “–“. You can disable only the Applying or Separating side, if you wish.

 

Top ▲

iOS Sky Now Settings

By default Sky Now and Houses Now use a continuously updating device location. However, they can be locked to a specific location so that they do not change when the device moves. For example, you might want to lock it to the location of the New York Stock Exchange.

Place – The location used when Location Services are not available, or when Always Use This Location setting is set to ON.

Always Use This Location:

  • ON – locks the location used by Sky Now and Houses Now to the location set on the Place row.
  • OFF – the location used by Sky Now and Houses Now updates when the device location changes. Location movement sensitivity is set to not update unless the device moves more than 8000 meters (approximately 5 miles).

The rest of the Sky Now settings work the same as those for Charts. See the section above for Chart Settings.

Note: iPhemeris does not collect or use location data for any other reason and no location data is sent to iPhemeris servers.

Top ▲

iOS Calendar Settings

Select how you prefer Ephemeris pages, Aspect and Transit Calendar features to display weeks. They can start on either Monday or Sunday.

The Transit Calendar displays transits to one of your saved charts. To use it you must first assign one of your charts as the Radix. To select one:

  1. Visit iPhemeris Settings.
  2. Scroll down to the Calendar section.
  3. Tap Transit Calendar Chart (Radix) row.
  4. Tap one of your charts to select it and return to Settings.

After selecting a Chart, Transit Calendar will function properly.

Top ▲

iOS Other Settings

ASTROLOGER INFORMATION

Add up to 5 lines of text that you want to appear on your charts. It will show up under the wheel in the lower right corner.

USE INTERNET ATLAS

When this setting is ON all features in iPhemeris which require a location, will allow selection of the location using the Map interface. Use of the Map interface requires access to the internet. We do not recommend setting this feature to OFF. When it is off you are required to use other means to lookup the Latitude and Longitude and enter them manually.

PRINTING DEFAULTS

If you have a color printer but wish to save ink, set this ON and iPhemeris will temporarily change the color scheme of the feature being printed to use the Black & White color scheme.

ICLOUD

Turn this ON to save charts in iCloud and share them with iPhemeris on all your other iOS and MacOS devices. This is the recommended setting, we do not recommend turning it OFF. Your astrological charts use very little data, probably less than one large photo 🙂 Please keep in mind that if you turn it OFF, you could lose all your Chart data.

If this settings is ON but Charts are not syncing to other devices, don’t turn it on/off. Instead, check the trouble shooting section located in the iOS Chart Data section further down.

LANGUAGE

iPhemeris displays in the primary language set for your device. You can force iPhemeris it to use one of the other languages we support by doing the following:

  • Tap the Row
  • Select one of the other languages.
  • Save the selected language by exiting out to settings.
  • Restart iPhemeris fully.

Top ▲

iOS Charts

iOS Charts – Quick Start

CREATING A CHART

Follow these steps:

  1. Tap the Charts tab to enter the Charts view.
  2. Tap the ‘+’ button located at the lower right of the view, to create (add) a new chart.
  3. Enter the required information from top to bottom. You must enter: name, date and time, place and time zone.
  4. The fastest way to set the correct time zone is to use the Clock button in the upper right of the Map View after you’ve selected a place. Use it after the map crosshairs are positioned on the place you want.
  5. Leave the Map View and Save the chart.

That’s it, you just created a chart!

DISPLAY A CHART

To display a Chart, follow these steps:

  1. Tap the row with the Chart you wish to display. It will get a check mark next to it.
  2. Tap the Show Charts button in the lower left.
  3. Select one of the items in the list:
    • Chart – will display single wheel with just the selected chart.
    • Chart +Now – will display the selected horoscope in a bi-wheel. The inner wheel shows the selected chart and the outer wheel shows position for “now”.

There is a full explanation of all toolbar buttons and settings in the following sections.

Top ▲

iOS Charts – Basics

Chart drawing is done from the Charts Tab. The interface is simple and after familiarizing yourself with a few buttons you should be able to get around quickly and easily.

help-charts-1

  • Add a Chart – Tap the ‘+’ button.
  • Edit a Chart – Tap the blue Info button on the right of each chart row.
  • Delete a Chart – Tap the Edit button (upper right), then the red button next to the chart.
  • Select a Chart – Tap the Chart row to select it. When selected it displays or . Select up to 2 charts.
  • Copy Selected Chart – When one (and only 1 chart is selected), the Copy button activates and will duplicate the selected chart. Copies save time and are useful for creating Progressed, Relocated or Solar Return charts to use in Bi-Wheels.
  • Draw Selected Charts – Select 1 or 2 charts and tap the Show Charts button.

DISPLAY – 1 CHART

  1. Select a chart by tapping its row.
  2. Tap Show Charts in lower left, and select “Chart”.

DISPLAY – Bi-WHEEL with SELECTED CHART & CHART of CURRENT PLACE & TIME

  1. Select a chart by tapping its row.
  2. Tap Show Charts in lower left, and select “Chart +Now”.

DISPLAY – 2 SELECTED CHARTS (Bi-wheel)

  1. Select the Chart for the inner wheel.
  2. Select the Chart for the outer wheel.
  3. Tap Show Charts in lower left, and select “2 Charts”.

DISPLAY – COMPOSITE or COMBINED CHART

  1. Select the first Chart to combine.
  2. Select the second Chart to combine.
  3. Tap Show Charts in lower left, and select “Composite”.

DISPLAY – 3 CHARTS in TRI-WHEEL

This feature is available as an In-App purchase. If you’ve purchased it you simply select 3 charts and they will display in a Tri-Wheel.

  1. Select any three charts.
  2. Tap Show Charts in lower left, and select “3 Charts”.

Top ▲

iOS Charts – Add or Edit

Setting up new horoscopes is fastest if you enter data in the order the fields are presented, top down.

  • When entering the time, enter it exactly as shown on the birth certificate. Do not adjust it for Daylight or Summer time.
  • If you have the Extended Ephemeris, enter “Old Style” dates prior to Oct. 15, 1582. To switch between BC and AD, simply tap the BC/AD text.
  • Tap Place and you’ll be presented with the Map View to find the location.
    • The Map View supports search and scrolling to the location.
    • After you’ve positioned the cross-hairs at the correct location use the Time Zone Lookup button (clock icon) in the upper right corner to get the Time Zone for the place under the cross-hairs.
    • Map and Time Zone lookup require Internet access.
  • Time Zone – This can be set from the Map View or manually from the Time Zone row. Mostly you will use the Find Time Zone button (after date, time and place are set) to get the correct time zone. Do not use Local Mean Time, unless you know what you are doing and when to use it, it is primarily for research and old dates.
  • House System – This will be pre-populated with the default house system, but if you wish to change it for the item currently being edited, you can do that here.
  • Place Name – This is not a place search field. Use the Map View for place search. This field displays the place name previously entered of found during search from the Map View. You can use this field to manually edit the place name.
  • Categories – Enter single words separated by a space or comma and which help organize your charts. For example: “Actor, male”. You can use these with the search bar at the top of the chart list to filter your charts to display only those items categorized with the word entered in the search bar.
  • Notes – Edit and add notes to charts from this field. They can also be edited while displaying the chart.

 

RELOCATION, PROGRESSED & SOLAR RETURN

Settings for Relocated, Progressed and Solar Return charts are towards the bottom of the chart editor view. Turn the Relocated, Progressed or Solar Return switch ON to draw the associated style of chart. Enter all required information.

RELOCATION CHART

  1. Set the Relocated button ON.
  2. Set a Place.
  3. Place Name is optional.

PROGRESSED CHART

  1. Set the Progressed button ON.
  2. Set Progress to Now to ON, to display a chart that is always progressed to current date and time.
  3. Or, set a specific date and time.
  4. Select the Planet and Cusp Progression style.
  5. Charts can be both Relocated and Progressed.

SOLAR RETURN CHART

  1. Set the Solar Return button to ON.
  2. Set a Year.
  3. Set Location to the place where the subject was at the time of the Solar Return.
  4. Set a Time Zone. It is best to use the Time Zone lookup button (clock thingy upper right) while getting the location.
  5. Place name is optional.
  6. Solar Return Charts cannot also be Relocated or Progressed.

NOTE: If the chart type does not remain selected after leaving the Edit Chart dialog, it is because iPhemeris did not find all the data needed to display that type of chart. Please check that you have entered all required information.

Top ▲

iOS Charts – Progressed, Relocated, Return

The fastest way to create Progressed, Relocated and Solar Return charts is to make a copy of the birth chart and then edit the copy and turn on settings for whichever type you want. Doing this allows you to display both the Natal chart whatever you are adding in a Bi-Wheel.

  1. Select a Natal Chart.
  2. Use the Copy button to duplicate the Chart.
  3. Edit one of the copies.
  4. Scroll down to the section for the type you want.
  5. Turn the switch ON.
  6. Enter all the additional required information.

Top ▲

iOS Charts – Chart Toolbar Explained

There are a number of controls on the chart display you should become familiar with.

 

The controls left to right:

Share – Allows you to share the currently visible chart via email, or text or save it to photos, etc.

Print – The currently visible chart. This requires that your iPhone can find an Air-Print enabled device.

Switch Display – Toggle between the wheel and the reports:

  • Wheel icon – displays chart wheel.
  • Grid icon – displays the report view. At the top of that view you can select one of the reports: Aspect Grid, Aspect list, Point list, and if purchased (requires In-App purchase) the Midpoint report.

Graphic Ephemeris – Requires an In-App purchase. Allows the overlay of chart lines on a Graphic Ephemeris.

Set Time Step – this button sets the time step interval used to advance charts back and forward in time. The menu also contains an option to hide the time step menu buttons. If you hide it, you can return to this menu to unhide it.

Display Notes – Add or edit chart notes.

Settings (Gear) – fast way to get to iPhemeris settings to change a chart display setting.

Time Step Toolbar:

  • Advance charts forward or back in time by the step interval.
  • Note: Progressed and Solar Return charts cannot be Time Stepped.

Top ▲

iOS Charts – Using Map Place Search

iPhemeris uses Apple maps technology to find latitude and longitude for places. It is far more precise than traditional Astrological Atlases and can be positioned to an exact location or address. This is very useful when charts have cuspy issues.

Note: Changes in location of only a few miles can change the ascendant.

  • Use standard gestures to scroll and zoom to a location.
  • Use the Search Bar to lookup a location.
  • To select a place, position the cross hairs over the desired spot on the map.
  • Use the Time Zone Lookup button (clock icon in upper right) to get the time zone for the location under the cross hair.
  • Time Zone lookup requires that Chart Date and Time are already set to work correctly.

 

help-mapview
 

Note: If you prefer to manually enter latitude and longitude, you can turn the Map off in Settings. Set Use Internet Atlas to OFF. This is not recommended.

Top ▲

Time Zone Lookup

iPhemeris uses an international, open source Time Zone database known as TZDATA. You can read more about it here: TZDATA on Wikipedia

  • Time Zone lookup requires Internet access (WIFI or a cellular data connection).
  • It requires that the: Date, Time and Location are already set.
  • Find Time Zone – This button queries the database for the Time Zone in effect for the data and time at the location.
  • Local Mean Time – Calculates a Time Zone based purely on Longitude. This is only recommended for researchers and very old dates.

TZDATA is contributed to and corrected by computer scientists all over the world. It was originally created to be an accurate source of Time Zone data for computer clocks which need to know when a specific location switches between regular and Summer or Daylight time DST. Due to the various and politically complex dates when places around the world have adopted and repealed Summer Time, the database can sometimes be off by 1 hour in a specific location. This is happening less and less frequently due to continuous updating and improvement.  Anyone finding errors can report it to TZData by providing 3 sources proving the error, e.g. newspaper articles, etc. TZDATA is now the most accurate historical record of time zone data and clock changes anywhere in the world.

For US locations, errors sometimes occur for dates prior to 1966 (when DST was mandated nationwide). When errors of this type occur, it is typically that the date for the switch between DT and DST is incorrect. This will produce an ascendant difference of approximately 15 degrees. If you are seeing an unfamiliar ascendant or midheaven value, do not assume iPhemeris is wrong, do a Google search for when Daylight/Summer time was adopted at the place of the chart being cast.

Some software uses an older source for historical time zone and daylight savings changes called the ACS Atlas and which is based on The Olsen Database, the predecessor to TZDATA. Unfortunately, the ACS atlas is known to be extremely error prone, so much so that the developers of TZDATA decided they could not use it as their starting point. They analyzed ACS’s accuracy and uncovered too many errors. The developers of iPhemeris have also observed over the years many errors in charts based on ACS. We therefore concluded that the safest approach was not to include it, and we suggest that when a discrepancy arises between TZDATA and a chart cast using ACS, to simply do the research.

Time zones and Daylight / Summer Time are an important subject for Astrologers to be familiar with and it will be well worth your time to study a bit about the subject.

Top ▲

iOS Ephemeris

iOS Ephemeris

The Ephemeris displays standard monthly tables of Longitude as well as Moon phases and Eclipses.

help-ephemeris-page

  • Ephemeris tables display a full month of Planetary, Lunar Phase and Eclipse data.
  • Positions (longitude) are Tropical or Sidereal as per Settings.
  • Data is grouped into weeks.
  • The GST column displays Greenwich Sidereal Time.
  • Two Moon columns are included:
    • The first displays Lunar position at Ephemeris Time as set in Preferences.
    • The second displays the position 12 hours later.
  • Columns for any body can be turned on or off in Settings. The Ephemeris and Dec/Lat tables share settings, i.e. changes on either view effect the other.
  • Planetary longitude data is read as follows:
    • DMS: 11!45″R = 11 degrees, 9 minutes 45 seconds, in the sign of Aries. The Planet is Retrograde.
    • DM: 12+1.9 = 11 degrees, 1.9 minutes in the sign of Aquarius.

NAVIGATION

  • finger swipe gestures (left or right) go back or forward 1 month at a time.
  • Navigate around table displays using standard iOS touch gestures.
  • Sharing button – provides printing, emailing or storing of pages to photos.
  • Search button – goes to a specific date.
  • Now button – returns to the current month.
  • Tap a row to highlight it, tap again to un-highlight.

Top ▲

iOS Declination & Latitude

The Dec/Lat feature displays standard Ephemeris style, monthly tables of Declination and Latitude for all planets and asteroids included with iPhemeris.

  • The table includes two columns for each body: Declination and Latitude.
  • Displayed values respect the DMS & DM precision Settings.
    • DMS: 25 n 28′ 59″ = 25 degrees North, 28 minutes, 59 seconds.
    • DM: 25 n 29 = 25 degrees North, 29 minutes.
  • Navigation is the same as for the Ephemeris.

Top ▲

Void of Course Moon Tables

Void of Course Moon tables display in the lower left of the Ephemeris and Declination / Latitude displays. The table is included with the Mac Version of iPhemeris, and is available as an In-App Purchase on iOS.

Void of Course Moon
Last Aspect Columns

  • Time Columns – the first 2 or 3 columns show the date and time of the event. There will be 3 columns when GMT, the Ephemeris Time Zone and Local time are not the same, other wise only two.
  • Last Aspect Column – Show the last planet to aspect the moon and the aspect it made.

Lunar Ingress Columns

  • Sign Column – Shows the next sign the moon entered (after the last aspect to its left).
  • Time Columns – 2 or 3 columns listing the time of the ingress event. As above there are 3 columns when GMT, Ephemeris Time Zone and Local time are not the same, other wise two.

The Void of Course period is the time between last aspect and the moon’s entrance into the next sign (Lunar Ingress).

Top ▲

iOS Graphic Ephemeris

iOS Graphic Ephemeris

The Graphic Ephemeris can be added to iPhemeris for iOS with a one-time In-App Purchase. The Graphic Ephemeris adds the following capabilities:

  • A new Graphic Ephemeris tab on the main view that:
    • Display planetary longitude and declination for any date range;
    • Displays harmonic ranges.
  • A new Graphic Ephemeris Report in charts that overlays the currently displayed chart data.

After purchasing you will find the feature activated on the More menu. You can move it wherever you like.

LONGITUDE

When longitude is selected, standard zodiacal positions for bodies are displayed. Customize what is shown from Settings: Planets & Chart Points.

Data is shown for the selected date range.  Use the toolbar buttons to select a range:

  • The Search button allows selection of any start/end date between 1700 and 2100.
  • The Now button jumps to 6 months either side of now.

 

DECLINATION

Declination can be displayed for the bodies selected in the sidebar by clicking the Declination button in the toolbar. Declination for most bodies is between -30° (south) and 30° (north) degrees of latitude. Use of harmonic ranges does not make sense for declination and therefore the degree range selector is disabled.

 

UNDERSTANDING THE DISPLAY

If you are not familiar with the display of a graphical ephemeris, it might help to understand for example, that bodies are in Aries when shown on the graph between 0° and 30° and they are in Pisces when between 330° and 360°.

Planets are conjunct where lines cross and they are in aspect to each other when they are separated vertically by the degrees of that particular aspect. For example, if the Sun is on the horizontal line labeled 30° (Aries/Taurus cusp) and Venus is on the horizontal line labeled 90° (Gemini/Cancer cusp) they are separated by 60° and are sextile on that date.

When Moon Phase is selected in the planet selector, New and Full Moon are displayed. New moon is shown where sun and moon lines cross and full moon where they are 180° apart.

 

HARMONIC RANGES

The harmonic range selector on the toolbar makes it possible to look for aspects by folding the data over on itself for the selected range. If you are not familiar with how this works, best to leave it set at 360°.

For example, if a range of 90° is set then the vertical scale is restricted to a range of 90° and things at 0°, 90°, 180° and 270° are all displayed at the 0° and appear to be conjunct. This makes it easy to spot aspects for the selected harmonic.

Harmonic ranges can only be used on the longitude display and are disabled when showing declination.

 

Top ▲

iOS Graphic Ephemeris Chart Report

 

ge-chart

When enabled, the Graphic Ephemeris Chart Report shows up as a new button on the Chart Display toolbar. For full details on how it works and what the buttons do, see the previous section. In brief you can:

  • Select a date range to display.
  • Display 6 months either side of now.
  • Select a harmonic degree range for Longitude.
  • Declination data cannot be shown with chart data.
  • When a horoscope is selected for display, the positions of the first chart (inner most wheel) are overlaid on the Graphic Ephemeris. These positions are shown as horizontal dashed lines.

Top ▲

iOS Calendars

Aspect Calendar

The Aspect Calendar shows the relationship between bodies in the sky on a particular date.

  • The displayJ0.0*@R1.0* is read as: Sun at 0.0° Capricorn, conjunct Uranus at 1.0° of Capricorn.
  • Any Body or Point can be turned ON or OFF in the Planets & Chart Points section of Settings.
  • Orbs for aspects are set in the Orbs section of Settings.
  • Navigation is the same as for the Ephemeris.

help-aspect-calendar

Top ▲

Transit Calendar

The Transit Calendar shows a full month of daily Transits between bodies in the sky and a Radix Chart you specify.

  • The Radix Chart is set in Settings and is a Chart from your Chart library.
  • Data to the left of the aspect glyph shows positions for things in the sky on that date.
  • Data to the right of the aspect glyph shows positions of aspected bodies in the Radix Chart.
  • Planets and Points can be turned ON/OFF in Settings. There are separate settings for things in the sky
    and things in the Radix.
  • The displayJ0*@R1*is read as Transiting Sun at 0° Capricorn, conjunct natal Uranus at 1° Capricorn.
  • Orbs used by Transit Calendar can be adjusted in the Orbs section of Settings.
  • Navigation is the same as for the Ephemeris.

help-transit-calendar

Top ▲

iOS Sky Now

iOS Sky Now

Sky Now displays a continuously updating Chart of the sky using the House System and Location specified in Settings.

  • When Location Services are available it uses current location.
  • When Location Services are not available or it is locked to a fixed location, it uses the Place specified in Settings.
  • iPhemeris is shipped with a default location set to New York City. Change it in Settings.
  • The display updates every 5 seconds.

Set Time Step:

  • Set the interval used to advance Sky Now back and forward in time.
  • Show/Hide the Time Step tool.

Note: Time stepping Sky Now stops real-time updates. To resume them tap the red button on the Time Step toolbar.

Time Step Toolbar:

  • Advance Sky Now chart forward or back in time by the step interval.
  • Start Real-time  – This button becomes red if real-time updates have been stopped by time stepping the chart. Tap to return to NOW and resume real-time updates.

 

sky now help
Note: If location is not updating and you think it should, check that you allowed iPhemeris to use your location in iPhone Settings.

Top ▲

iOS Houses Now

Houses Now displays a continuously updating list of House Cusps using the House System and Location specified in Settings. It uses the same settings as Sky Now, set in the Sky Now section of Settings.

  • When Location Services are available it uses current location.
  • When Location Services are not available or it is locked to a fixed location, it uses the Place specified in Settings.
  • iPhemeris is shipped with a default location set to New York City. Change it in Settings.
  • The display updates every 5 seconds.

Note: If location is not updating and you think it should, check that you have allowed iPhemeris to use your location in iPhone Settings.

Houses Now

Top ▲

iOS iCloud Chart Data

iCloud

iPhemeris can use iCloud to backup and share your astrological chart data between iPhemeris on all your iOS and Mac devices. The first time iPhemeris sees an active iCloud account on a device, it asks if you would like to use iCloud. It only asks once, should you decide to turn it on later, you can do so from iPhemeris Preferences on the Mac or iPhemeris Settings on iOS.

We strongly recommend you use iCloud as a means of backing up your charts. 

USING iCLOUD

  1. iOS Devices – Enable iPhemeris to use iCloud from iPhemeris Settings.
  2. MacOS Devices – Enable iPhemeris to use iCloud from iPhemeris Preferences.
  3. Make sure iPhemeris is enabled to use iCloud Drive in iOS System Settings or Mac System Preferences. iCloud Drive must be enabled and iPhemeris permissioned to use it for you to be able to save and share charts.

iOS – ENABLE iCLOUD DRIVE on iOS

  1. On your device goto System Settings.
  2. Tap your name at top left where Apple ID, iCloud… is shown.
  3. In list on right tap iCloud which is near top.
  4. Scroll down and make sure iCloud Drive is on.
  5. Scroll further down and make sure iPhemeris is on.

icloud2

Step 3

icloud3
 

MacOS – ENABLE iCLOUD DRIVE on MacOS

  1. Goto Mac System Preferences.
  2. Select Accounts.
  3. Select iCloud account in list on left side. If you do not see it then your device is not yet logged into iCloud.
  4. If you DO see it, select it and then in the window to the right click the Options button next to iCloud Drive.
  5. Find iPhemeris in the list and make sure it is selected as shown in the image below.

Step 3

iCloudDriveMac-3
 

HANDLING DUPLICATE CHARTS

  1. First, turn iCloud on in iPhemeris on ALL devices you intend to use it with.
  2. Second, allow it to finish syncing all devices. This can take several minutes or hours and it is best to wait until you see all your charts appear on all devices.
  3. Finally, choose one and only one device and delete the duplicates. Deletions will automatically propagate to all your other devices.

DIABLING ICLOUD

This is not recommended. Turning iCloud OFF means that you will have no backup for your astrology charts and if something happens to your system of your installation of iPhemeris, you will not be able to recover them unless the system is fully backed up some other way.

  • You can disable iCloud in iPhemeris from iPhemeris Settings.

 

TROUBLE SHOOTING

iPhemeris NEVER deletes your chart data for any reason. Only you can delete charts. Therefore if you are not seeing charts on a new device or after an upgrade of iOS check all of the following:

  1. You are logged into iCloud.
  2. You are logged into the same iCloud account you used on the previous device.
  3. You have an internet connection.
    • Any WIFI connection will work.
    • If the connection is only mobile make sure that mobile data is enabled and iPhemeris is enabled to use it. The settings to enable iPhemeris to use mobile data are typically in the cellular section of iOS Settings App. Chart syncing requires mobile data when the connection is exclusively mobile (no WIFI).
  4. If the first three are ok and you still cannot save charts check that you have not exceeded your iCloud storage limit.

 

Can’t Save Charts

  1. Check that you have not reached your iCloud storage quota. If you are out of storage iPhemeris will fail silently. The simplest solution is to free up space by deleting some of the likely thousands of photos you have up there 🙂
  2. iPhemeris can also fail to save charts if iCloud is ON in iPhemeris Preferences but not enabled to use iCloud Drive. See above instructions to enable iCloud Drive.
  3. iCloud sync and storage cache can become corrupt. This can be fixed by simply logging out of iCloud and back in again.

Top ▲

Manual Backup & Move

iCloud

If you use iCloud to store Charts, data is automatically backed up and shared with iPhemeris on other devices. In this case, this topic is not relevant. Note: When using iCloud, iPhemeris can be safely deleted from a device and re-installed without any Chart loss.

Manually Backing Up & Moving Chart Data

Chart data can be manually backed up and also moved between iOS devices. Please be careful when doing this so as to not render the Chart database unusable. This is only possible when iPhemeris is NOT storing Charts in iCloud.

Backup And Move Guidelines

Follow these instructions to prevent damage to the iPhemeris chart database:

  • It is OK to move data between devices running the same version of iPhemeris.
  • It is OK to move data from a device running an older version (lower version number) of iPhemeris to a device running a newer version (higher version number) of iPhemeris. Eg. From 8.6 to 9.0.
  • Never move data from a newer version of iPhemeris to an older version.
  • The safest way to Backup is to use iCloud.
  • When not using iCloud to Backup Charts, save a copy of the files described in the steps below in a safe place.
  • When doing manual Backup, run iPhemeris several times to ensure that it has had an opportunity to update the Chart database. Then make a new backup copy.

Backup And Move Steps

To backup or move data to another device, follow these steps:

  1. Connect the devices you want to move data between, to a Mac running iTunes.
  2. Open iTunes and sync both devices.
  3. Select the device you want to move charts from in iTunes.
  4. On the main panel where Device Summary is showing, select “Apps”.
  5. Scroll down to the “File Sharing” section.
  6. Select iPhemeris in the list and you will see a file called iPhemeris.sqlite on the “iPhemeris Documents” panel.
  7. Copy that file to your desktop using the Save button.
  8. Next select the other device you want to move charts to in the sidebar and navigate to the same panel.
  9. Use the Add button to move the iPhemeris.sqlite file from the desktop to the other device.
  10. Sync the second device again and it will have all the charts you just moved.

WARNING: This completely replaces the Chart data on the second device with charts from the first.

Top ▲

Symbols

Planets & Points

J Sun Soleil Sol Sonne
N Moon Lune Luna Mond
K Mercury Mercure Mercurio Merkur
L Venus Venus Venus Venus
[ Earth Terre Tierra Erde
O Mars Mars Marte Mars
P Jupiter Jupiter Jupiter Jupiter
Q Saturn Saturne Saturno Saturn
R Uranus Uranus Urano Uranus
S Neptune Neptune Neptuneo Neptun
T Pluto Pluton Pluton Pluto
: Pluto (esoteric) Pluton Pluton Pluto
U Chiron Chiron Chiron Chiron
V Vesta Vesta Vesta Vesta
W Pallas Pallas Pallas Pallas
X Juno Juno Juno Juno
Y Ceres Ceres Ceres Ceres
Z Cupido Cupido Cupido Cupido
^ Astraea Astraea Astraea Astraea
_ Hygiea Hygiea Hygiea Hygiea
` Eris Eris Eris Eris
a Eris (Alternate) Eris (alt) Eris (alt) Eris (alt)
b Sedna Sedna Sedna Sedna
c Vulcan Vulcain Vulcano Vulkan
4 Vulcan (Alternate) Vulcain Vulcano Vulkan
9 Black Moon (Lilith) Lune Noire Negro Luna Schwarze Mond
] N. Node Noeud N. Nodo N. N. Mondknoten
\ S. Node Noeud S. Nodo S. S. Mondknoten
Ascendant Ascendant Ascendente Aufwind
3 Descendant Descendant Descendiente Absteigend
. Mid Chart Mid Chart Mid Chart Mid Chart
/ Imum Coeli Fond du Ciel Imum Coeli Imum Coeli
2 Vertex Vertex Vertex Vertex
1 Part of Fortune Pt. Fortune Pt. Fortune Teil Glücks
0 Retrograde Retrograde Retrógrada Umgekehrt

 

Uranian (Hamburg) Hypothetical Bodies

These are now known not to exist, however some wanted them so they have been added as an In-App purchase. Have at it 😉

d Cupido Cupidon Cupido Cupido
e Hades Hadès

Infierno

Hades
f Zeus Zeus Zeus Zeus
g Kronos Kronos Krono Kronos
h Apollon Apollon Apolo Apollon
i Admetos Admète

Admeto

Admetos
j Vulkanus Vulcain

Vulcano

Vulcanus
k Poseidon Poséidon

Poseidón

Poseidon

Top ▲

Aspects

@ Conjunction Conjonction Conjuncion Konjunktion
A 30° Semisextile Semisextile Semisextil Halbsextal
n 36° Decile Decile Decile Decile
? 40° Novile Novile Novil Novile
B 45° Semi-square Semi-carre Semi-cuadratura Halbquad-
ratisch
p 51.4° Septile Septile Septile Septile
C 60° Sextile Sextile Sextil Sextaler
D 72° Quintile Quintile Quintil Quitil
= 80° Bi-Novile Bi-Novile Bi-Novil Bi-Novile
E 90° Square Carre Cuadratura Quadratisch
o 108° TreDecile TreDecile TreDecile TreDecile
F 120° Trine Trigone Trigono Trigon
G 135° Sesqui-square Sesqui-carre Sesqui-
cuadratura
Anderthal-
bquadratisch
< 144° Bi-Quintile Bi-Quintile Bi-Quintile Bi-Quintile
H 150° Quincunx Quinconce Quinconce Quincunx
> 160° Quad-Novile Quad-Novile Cuad-Novil Quad-Novile
q 165° QuinDecile QuinDecile QuinDecile QuinDecile
I 180° Opposition Opposition Opposicion Opposition
r Parallel Parallel Parallel Parallel
s 180° Contra-parallel Contra-parallel Contra-parallel Contra-parallel

Top ▲

Signs

! Aries Belier Aries Widder
Taurus Taureau Tauro Stier
# Gemini Gemeaux Geminis Zwillinge
$ Cancer Cancer Cancer Krebs
% Leo Lion Leo Lowe
& Virgo Vierge Virgo Jungfrau
Libra Balance Libra Waage
( Scorpio Scorpion Escorpion Skorpion
) Sagittarius Sagittaire Sagitario Schutze
* Capricorn Capricorne Capricornio Steinbock
+ Aquarius Verseau Aquario Wassermann
, Pisces Poissons Piscis Fische

Top ▲

Vedic

Ayanamsa

Ayanamsa Degree Offset From
Tropical Epoch 2000
D.K. *
28.37194647
Fagan Bradley
24.73666667
Lahiri
23.85305556
Krishnamurti
23.76194444
Galactic
25.00000000
Raman
22.40694444
Takra I
24.50027778
Takra II
24.54222222
Babylonian
24.78666667
Deluce
27.80555556
Larry Ely
28.00361111
Yukteshwar
22.47777981
Sassanian
19.99222425
Ushashashi
20.05639092
Hipparchus
20.24611314
Dhira
23.06666870
Krushna
22.95166870
* Courtesy of Keith Bailey who made available the date for the first decanate of the Age of Aquarius from some unpublished writings and instructions of the Master D.K. that were entrusted to his care.

Top ▲