.. Adnite2 documentation master file, created by sphinx-quickstart on Thu Jul 9 11:22:10 2015. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. .. include:: ======================== AdNite2 - Documentation ======================== .. :Author: D.Thaler .. :Created: 2016-03-18 .. :Last changed: 2016-04-22 :program:`AdNite2` is a GNU/Linux based Python>=3.4 free open source program suite that calculates basic astronomic data, moon positions and night time illuminance values dependent on meteorological conditions. It is licensed with the European Public License :ref:`(EUPL)`. .. note:: May 25th, 2018: :doc:`datenschutzerklaerung` (German only) **New**: Version 0.2.20170422 with minor bug fixes. For download see: http://downloads.foehnwall.at/adnite2.html It is based on the opensource project adnitevision at `adnitevision.foehnwall.at `_ which was not more than a prove of concept. :program:`AdNite2` is now supposed to be a more appealing piece of software. For download see `here `_. Demo output =========== +----------------------------+---------------------------+ | .. image:: pics/illum.png | .. image:: pics/moon.png | | :width: 100% | :width: 100% | | :align: center | :align: center | +----------------------------+---------------------------+ Download :download:`a demo pdf-output from here `. Motivation ========== * Night time illumination calculation programs dependent on weather and surface conditions are generally not available at the free market. They are mainly designed for military use and therefore considered as a sort of confidential information. * During the last few years high quality night vision equipment has become available at a reasonable price also for civil use. Therefore a demand for some basic night illuminance information is existing for a broader public. The basic calculation procedures and formulas can be derived from freely available literature (see section :ref:`background`). Based on this rough estimates this simple program has been designed and written. * Because the author has been using open source software for decades this software is considered to be a tiny payback to the open source community (see :ref:`license`). Caveat ====== .. warning:: Everybody must always be aware that all calculated night time illuminance values are at its best an **educated guess** for real night time situations. Observed values can vary due to a manifold of reasons that are not coverd by this approach. - For more details see section :ref:`approximations`. -- **The use of the application AdNite2 is at your own risk!** **Deutsch**: Man muss sich immer bewusst sein, dass jede berechnete Nacht-Helligkeit bestenfalls eine **begründete Schätzung** für reale Nachtverhältnisse darstellt. Beobachtete Werte können davon durch eine vielfältige Reihe von Gründen abweichen, die nicht durch die hier vorliegende Abschätzung abgedeckt sind. - Für nähere Details siehe Abschnitt :ref:`approximations`. -- **Die Nutzung der Anwendung AdNite2 erfolgt auf eigene Gefahr!** Both, program and documentation, is not perfect. - Help to improve it. Report errors and proposals to **adnite(at)foehnwall(dot)at** The author appreciates every **help**, especially * for making the software available on `GitHub `_ or anything similar * for porting the software to Windows\ |reg| and other operating systems, * for removing the dependency on external programs like *rst2pdf* and *rst2html*. Download ======== The most recent version of :program:`AdNite2`: http://downloads.foehnwall.at/adnite2.html Content ======= .. toctree:: :maxdepth: 2 :numbered: README programs files sqlite3db background config approxis bugs changelog Datenschutzerklärung impressum