KosherJava » Download http://www.kosherjava.com A weblog about Zmanim, Kosher Coffee (Kosher Java) and other odds & ends Fri, 06 Jan 2012 18:28:48 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 FAQ: How do I Calculate the Jewish/Hebrew Date for …? http://www.kosherjava.com/2011/02/23/faq-how-do-i-calculate-the-jewish-hebrew-date-for/?utm_source=rss&utm_medium=rss&utm_campaign=faq-how-do-i-calculate-the-jewish-hebrew-date-for http://www.kosherjava.com/2011/02/23/faq-how-do-i-calculate-the-jewish-hebrew-date-for/#comments Wed, 23 Feb 2011 05:14:16 +0000 KosherJava http://www.kosherjava.com/?p=266

Question:

How do I get the Jewish Date for … using the Zmanim API?

Answer:

The current version of the Zanim API does not support Jewish calendrical calculations. Zmanim are almost exclusively based on the solar calendar, so for example, the sunrise on February 8th this year in Montreal (or any other date and location), will be almost the same every year. for this reason there was little point (as far as zmanim) to support Jewish date calculations in the API. One of the only zmanim to rely on a Jewish date is the sof zman kidush levanah calculation, though there are some opinions that it is purely molad based, and this can be calculated without a Jewish calendar component to the API. This zman is obviously not currently implemented in the Zmanim API. I am currently working on adding Jewish date support to the API. The code is based off Avrom Finkelstein‘s no longer active HebrewDate project. I refactored a lot of the code and fixed a number of bugs. Anyone interested in alpha testing this code can download the latest Zmanim SVN code (or download the Zmanim API 1.3.0 alpha release). I mentioned that it “will be almost the same every year” and this is due the the approximate 1/4 day drift between the 356 day calendar year and the approximately 365.25 days actually present in the astronomical year, a discrepancy corrected every leap year. A future FAQ (probably a few of them) may delve specifically into this drift as well as general zmanim accuracy issues in detail. If you are simply looking to convert a Hebrew date to Gregorian or Gregorian to Hebrew online without the API, try the JewishGen calendar conversion tools.]]> http://www.kosherjava.com/2011/02/23/faq-how-do-i-calculate-the-jewish-hebrew-date-for/feed/ 9 Zmanim API 1.2.1 Released http://www.kosherjava.com/2010/05/30/zmanim-api-1-2-1-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-api-1-2-1-released http://www.kosherjava.com/2010/05/30/zmanim-api-1-2-1-released/#comments Mon, 31 May 2010 02:36:11 +0000 KosherJava http://www.kosherjava.com/?p=657 The Zmanim API 1.2.1 was released today. Changed in this release were the addition of a few very early Tzais zmanim, and the removal of references to the GregorianCalendar in favor of the base Calendar class to ease Noah Blumenthal’s use of the Zmanim API in a zmanim application for the BlackBerry. This change has no impact on functionality as tested using Yitzchok’s new JUnit tests. Additionally, the JavaDoc Zmanim API documentation was modified to clearly indicate that zmanim can return nulls. A followup post will have details on this. The main download is the Zmanim 1.2.1 release zip file that includes source files and JavaDoc documentation. Also available for download (included in the above zip file) is the main zmanim-1.2.1.jar and the zmanimAstronomical-1.2.1.jar that only includes the AstronomicalCalendar. The removal of the GregorianCalendar was in this class. Additional detail on the downloads can be seen on the Zmanim Download page]]> http://www.kosherjava.com/2010/05/30/zmanim-api-1-2-1-released/feed/ 0 ZmanimPlasma (Linux) Released http://www.kosherjava.com/2010/04/12/zmanimplasma-linux-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanimplasma-linux-released http://www.kosherjava.com/2010/04/12/zmanimplasma-linux-released/#comments Tue, 13 Apr 2010 03:52:15 +0000 KosherJava http://www.kosherjava.com/?p=524 Moshe Wagner recently released ZmanimPlasma for the Linux platform. This KDE Plasma desktop widget displays the Hebrew date and zmanim on a Linux desktop. The zmanim calculations use Moshe’s C++ port Zmanim CLI wrapper that enables a C++ program to call the Java Zmanim API. There are no current plans to make this widget available on any other platform. It can be downloaded from the Luach project download page. Moshe has in the past used the Zmanim API for use in Linux and some cross platform projects. These include the above mentioned Zmanim CLI, and Zmanim GUI that uses the ZmanimCLI. Updated on 4/13/2010 to reflect information from Moshe explaining that this was not a port]]> http://www.kosherjava.com/2010/04/12/zmanimplasma-linux-released/feed/ 1 Zmanim API 1.2 Released http://www.kosherjava.com/2010/01/24/zmanim-api-1-2-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-api-1-2-released http://www.kosherjava.com/2010/01/24/zmanim-api-1-2-released/#comments Mon, 25 Jan 2010 02:07:29 +0000 KosherJava http://www.kosherjava.com/?p=409 The Zmanim API 1.2 was released today. The only change in this release is the removal of elevation as a factor in the calculation of all zmanim besides sunrise and sunset. Updated JavaDocs now reflect these changes. Please see the Elevation Now Only Impacts Sunrise and Sunset Calculations in the Zmanim API post for additional information. I would like to thank the various people who contacted me on the subject. The main download is the Zmanim 1.2 release zip file that includes source files and JavaDoc documentation. Also available for download (included in the above zip file) is the main zmanim-1.2.jar. The zmanimAstronomical-1.1.jar that only includes the AstronomicalCalendar was not impacted by this change, but the version has been updated to zmanimAstronomical-1.2.jar for consistency. Additional detail on the downloads can be seen on the Zmanim Download page]]> http://www.kosherjava.com/2010/01/24/zmanim-api-1-2-released/feed/ 0 Zmanim API 1.1 Released http://www.kosherjava.com/2009/03/27/zmanim-api-11-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-api-11-released http://www.kosherjava.com/2009/03/27/zmanim-api-11-released/#comments Fri, 27 Mar 2009 18:49:02 +0000 KosherJava http://www.kosherjava.com/?p=137 The Zmanim API 1.1 was released early this morning. Information about what changed in this release can be seen in previous posts about various beta and patch releases. A last minute change involved the removal of the misheyakir calculations commonly used by the Syrian community. The removal was due to the various different minhagim used, and Chacham Yosef Harari-Raful not endorsing any one, or including any, in his calendar. The API is flexible enough to be used for any calculation wanted by the various Syrian shuls even without “native” support for a built in “Ateret Torah” misheyakir. Some missing JavaDocs were also added. I would like to again thank Rabbi Rachamim Ashkenazi the publisher of a zmanim calendar for the Syrian Community, and Victor Grazi for his input, testing and technical expertise used for adding the new “Ateret Torah” zmanim. The main download is the Zmanim 1.1 release zip file that includes source files and JavaDoc documentation. Also available for download (included in the above zip file) is the main zmanim-1.1.jar and the new zmanimAstronomical-1.1.jar that only includes the AstronomicalCalendar and supporting classes. Additional detail on the downloads can be seen on the Zmanim Download page]]> http://www.kosherjava.com/2009/03/27/zmanim-api-11-released/feed/ 0 Zmanim GUI Released http://www.kosherjava.com/2009/03/14/zmanim-gui-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-gui-released http://www.kosherjava.com/2009/03/14/zmanim-gui-released/#comments Sun, 15 Mar 2009 04:09:47 +0000 KosherJava http://www.kosherjava.com/?p=105 I was recently contacted by Moshe Wagner who wanted to know if there was a graphical front end to the Zmanim API. While there are various programs that do use the API, there is no standalone Java GUI that uses the API (the zmanim clock applet is not easily useful for looking up zmanim for various locations). As first announced in Hebrew ( ZmanimGUI – ממשק להצגת זמני היום ההלכתיים ), Moshe took the API and wrote a Java Swing GUI for the API. The Zmanim GUI (called זמני היום in Hebrew) can switch between Hebrew and English display and shows the most common list of zmanim typically used. The program requires Java 6 and can be launched by double clicking on the ZmaniGui jar file (or execute the command ‘java -jar ZmaninGui.jar’ from a command prompt). As with the Zmanim API, the GUI was released under the GPL2 and is available (including source) on our download page (direct link to version 0.0.87 updated on May 12, 2009). Questions and comments can be posted here, or sent directly to Moshe at moshe.wagner -AT- gmail.com.]]> http://www.kosherjava.com/2009/03/14/zmanim-gui-released/feed/ 0 Zmanim API 1.1 Beta 3 Released http://www.kosherjava.com/2009/02/25/zmanim-api-11-beta-3-released/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-api-11-beta-3-released http://www.kosherjava.com/2009/02/25/zmanim-api-11-beta-3-released/#comments Wed, 25 Feb 2009 05:57:32 +0000 KosherJava http://www.kosherjava.com/?p=96 The third beta release of the Zmanim API 1.1 is now available on the download page. The main change in this release is the addition of zmanim based on the psak of Chacham Yosef Harari-Raful of Yeshivat Ateret Torah. These zmanim were requested by members of the Syrian Community. Other changes in this release include various additions and fixes to the API JavaDocs. I hope to post some detailed information about the new “Ateret Torah” zmanim in the near future. I would like to thank Rabbi Rachamim Ashkenazi the publisher of a zmanim calendar for the Syrian Community for his help with the “Ateret Torah” zmanim. The main download is the Zmanim 1.1 beta 3 release zip file including source files and documentation. Also available for download (included in the above zip file) is the main zmanim-1.1_beta_3.jar and the new zmanimAstronomical-1.1_beta_3.jar that only includes the AstronomicalCalendar and supporting classes.]]> http://www.kosherjava.com/2009/02/25/zmanim-api-11-beta-3-released/feed/ 0 Zmanim API 1.1 Release Candidate Available http://www.kosherjava.com/2008/04/17/zmanim-api-11-release-candidate-available/?utm_source=rss&utm_medium=rss&utm_campaign=zmanim-api-11-release-candidate-available http://www.kosherjava.com/2008/04/17/zmanim-api-11-release-candidate-available/#comments Thu, 17 Apr 2008 10:12:59 +0000 KosherJava http://www.kosherjava.com/2008/04/17/zmanim-api-11-release-candidate-available/ A release candidate (RC1) of the Zmanim API 1.1 is now available on the download page. Changes in this release include a slight clean up of the recently released NOAACalculator code (does not change calculated times), as well as fixes to the date (but not time) of calculations for locations near the arctic circle. This date fix builds on the February release of the API to fix an arctic circle issue and a similar issue encountered when trying to generate zmanim for locations other than the local timezone. Also included in this release is the zmanimAstronomical-1.1.jar, a release that only includes the AstronomicalCalendar class and supporting classes. There was also some code refactoring to make the code easier to maintain. A detailed post will follow (hopefully within the next week or so).]]> http://www.kosherjava.com/2008/04/17/zmanim-api-11-release-candidate-available/feed/ 0 Fix to NOAA Sunrise/Sunset Algorithm http://www.kosherjava.com/2008/04/13/fix-to-noaa-sunrisesunset-algorithm/?utm_source=rss&utm_medium=rss&utm_campaign=fix-to-noaa-sunrisesunset-algorithm http://www.kosherjava.com/2008/04/13/fix-to-noaa-sunrisesunset-algorithm/#comments Mon, 14 Apr 2008 04:01:41 +0000 KosherJava http://www.kosherjava.com/2008/04/13/fix-to-noaa-sunrisesunset-algorithm/ The Zmanim API was developed from the ground up as an API which allows for easy plugging in of different algorithms. The Zmanim API ships with 3 “Calculator” implementations. Two calculators implement the US Naval Observatory’s algorithm, the SunTimesCalculator and the ZmanimCalculator. Both produce identical zmanim using slightly different code and are included for comparison. There is also the JSuntimeCalculator, an implementation of the NOAA algorithm by Jonathan Stott. I was recently contacted by Eliezer Bulka who wanted to know why sunrise/sunset times generated by the NOAA algorithm were about 2 minutes off of the sunrise/sunset times generated by the NOAA JavaScript implementation that is the source of the JSuntimeCalculator. To compare apples and apples required modification of the NOAA JavaScript to allow entry of decimal latitude/longitude, and changing the output to display seconds. No change was made to the algorithm itself. I then ported the JavaScript directly to Java. This involved nothing more than slight syntax changes between the languages. Once this was done I noticed that the sun rise/set output from the Java port exactly matched the output of the NOAA JavaScript. Analysis of Jonathan’s code showed (or at least my interpretation of it did) that there were two areas that caused the difference. Once is that he used a slightly different method of computing the Julian date, a key part of the algorithm. His change includes the time of day as part of the calculation. The net result of this change is that solar time generated using his algorithm varies based on the time of day the calculation is run, something that is incorrect. This means that there can be a discrepancy of up to one calendar day. If the user calculated sunrise at 11:59 PM, sunrise would be calculated for the following day even if the user attempted to calculate it for today. In addition, the other calculations do not match the output of the matching NOAA code. I have deprecated the JSuntimeCalculator and in its place added the NOAACalculator that was the result of the direct port of the NOAA code, shoehorned into the Zmanim API Calculator interface. I ran some tests to compare the maximum and minimum discrepancy between the 2 implementations, and calculations for Lakewood, NJ, latitude 40.0828, longitude -74.2094 show a discrepancy of between a minute and 34 seconds to a minute and 37 seconds for sunrise and sunset across an entire year of sunrise and sunset calculations. I also compared the USNO algorithm to the new NOAA implementation and ended up with a maximum deviation of less than 30 seconds, something that had been about 1.5 minutes apart previously. While I do believe that the Julian date calculation is a bug, I do not know that this is a case as far as the rest of the calculation, but it is clear that it does not match the NOAA implementation that is was based on, and I recommend that you download the latest version that has the new NOAACalculator that fixes this issue. In addition to this fix, an additional patch will be released later this week that will address issues with calculations in the arctic circle. Stay posted for the next post.]]> http://www.kosherjava.com/2008/04/13/fix-to-noaa-sunrisesunset-algorithm/feed/ 1 Updated Zmanim Jar Released – Please Download the Latest http://www.kosherjava.com/2008/02/07/updated-zmanim-jar-released-please-download-the-latest/?utm_source=rss&utm_medium=rss&utm_campaign=updated-zmanim-jar-released-please-download-the-latest http://www.kosherjava.com/2008/02/07/updated-zmanim-jar-released-please-download-the-latest/#comments Thu, 07 Feb 2008 20:42:04 +0000 KosherJava http://www.kosherjava.com/2008/02/07/updated-zmanim-jar-released-please-download-the-latest/ In December when developing the Zmanim/Bearing to Yerushalayim map (blog post), I noticed a problem with the code used to generate zmanim. The API returns a Java Date object. Usually only the time is of interest, and the date is ignored, but in some cases (when a timezone offset is specified without using the Olson DB name (such as America/New_York) or if the GMT timezone is used for other locations, and the local standard time is calculated as an offset of GMT), the date of the sunset returned was earlier than the sunrise date. This caused zmanim such as Sof Zman Shema for some locations to be incorrect, since the math used was comparing surnise to a sunset on the incorrect date, causing some very odd behavior. Updated files that correct this issue were uploaded to the site on Dec 26th. I was notified today by a developer using the jar, that not all the download links were pointing to the updated versions, and this caused issues for his program (a post about his project will be posted in the near future). All the links have now been updated. Since the old code can sometimes generate incorrect zmanim, it is highly suggested that you replace your current jar with the latest version of zmanim.jar (or zmanim.zip).

Along with the fix mentioned above, a number of other small fixes were done. These include among other minor issues, fixed, better and simplified XML output from the toString method, better error handling for expected error conditions, that had previously caused errors in the generations of zmanim for areas in the arctic circle such as Thule, Greenland. In case you are curious, someone did actually try this, and the error logs lead me to find the issue. The IP address used for the request mapped back to the Thule Air Base.]]> http://www.kosherjava.com/2008/02/07/updated-zmanim-jar-released-please-download-the-latest/feed/ 0