System files and and directories ================================== Configuration directory ----------------------- The configuration directory is a "hidden" Unix/Linux-directory below the users home directory: :file:`~/.adnite2/`. * Sub directories: * :file:`.adnite2/doc/` Contains the html documentation starting with :file:`~/.adnite2/doc/index.html` * :file:`~/.adnite2/logfiles/` Contains logfiles of the different session * :file:`~/.adnite2/logo/` Contains the program logo in different resolutions * Files: * :file:`~/.adnite2/default.cfg` Main configuration file, see below. * :file:`~/.adnite2/template.rst` RestructuredText template: contains the invariant part of the output form sheed and has instruction to iclude the variant tables and images. * :file:`~/./adnite2/default.prm` Default parameter file for the default filling of the adnite2-gui. * :file:`~/./adnite2/default.css` CSS-file for the html-putput. This special css has been borrowed from the `Sphinx project theming support `_, forgotten which one :-) * :file:`~/./adnite2/default.sheet` Style sheet for the pdf-output, taken from the `rst2pdf project `_. Configuration file .................... Configuration file :file:`~/.adnite2/default.cfg` entries are used to control the basics behavior of the program. * Program logo * Program title * Root output directory * Html help file * External program names * Some astro-physical constants The configuration file is read at program start and used by all modules. .. code-block:: sh # Configuration file with parameters # Single parameters: name; value # List parameters: name; value1; value2; value3 # Separate all vaulues with semicolon ; # Start comments with # # # adnite work horse program adnite; adnite2-cli # internet browser browser; firefox # cloudalbedos, ranking must coincide with cloudtypes, cloudnames cloudalbedos; 0.3; 0.55; 0.75; 0.9 # cloudamount (0 .. SKC, 10 .. OVC) cloudamount; 0; 1; 2; 3; 4; 5; 6; 7; 8; 9; 10 # cloudnames (for fom sheeds, must have 5 characters!) cloudnames; thin; thn.m.; thk.m.; thick # cloudtypes cloudtypes; 0; 1; 2; 3 # favorite stations (at least one, as many as you like) favorites; LOWG; LOWI; LOWS; LOWL; LOWK; LOWW; LOXT; LOXZ; LOXE; LOXA # groundalbedos (must coincide with groundtypes, groundnames) groundalbedos; 0.80; 0.50; 0.35; 0.25; 0.10; 0.05 # groundnames (not longer than 7 character) groundnames; frsh sn; old sn; frozen; dry; humid; wet # Groundtypes (3 characters) groundtypes; SNF; SNO; FRZ; DRY; HUM; WET # html-help site helpsite; ~/.adnite2/doc/index.html # upper alert illuminace (not used) illum_alert_higher; 2.0e-3 # lower alert illuminance for horizontal threshold line) illum_alert_lower; 0.5e-3 # civil twilight illuminance (clear sky conditions) illum_civiltwilight; 3.0 # deep night illuminance (SKC conditions) illum_deepnight; 2.0e-3 # sunset illuminance (SKC conditions) illum_sunset; 7.5e2 # program logo logopath; ~/.adnite2/logo/logo.png # pdv-viewer pdfviewer; evince # name of the program fotr displaying progname; AdNite2 # rst to html converter program rst2html; rst2html # rst to pdf converter program rst2pdf; rst2pdf # title for gui titlegui; AdNite2 - Night Vision Tool # text viewer (not used) viewer; firefox # work directory # Defines matplotlib plotstyle (1: sloppy, 0: normal) xkcd; 0 .. warning:: Do not edit :file:`~/.adnite2/default.cfg` unless you know what you are doing. A corrupted configuration file means program crash. Parameter file -------------- The parameter file is written by the graphical user interface :program:`adnite2` to the outputdirectory (= workdirectory + '/' + station), e.g. :file:`/home/thl/uCloud/test/adnite2-wx/LOWG` and contains all information to be run by :program:`adnite2-cli` with its different options. :: times; 15:00; 17:00; 19:00; 21:00; 23:00; 01:00; 03:00; 05:00; 07:00 outdir; /home/thl/adnite2-work/LOWG groundx; WET; WET; WET; WET; WET; WET; WET; WET; WET cloudsd; 0; 0; 0; 0; 0; 0; 0; 0; 0 cloudsnx; 10; 10; 10; 10; 10; 10; 10; 10; 10 rstfile; /home/thl/adnite2-work/LOWG/adnite.rst illum_goutfilen; /home/thl/adnite2-work/LOWG/illum.png moon_goutfilen; /home/thl/adnite2-work/LOWG/moon.png rsttemplate; /home/thl/.adnite2/template.rst moon_outfilen; /home/thl/adnite2-work/LOWG/moon.csv cloudsn; 0; 0; 0; 0; 0; 0; 0; 0; 0 basics_outfilen; /home/thl/adnite2-work/LOWG/basics.csv date1; 2016-03-21 rsttable; /home/thl/adnite2-work/LOWG/adnite_table.rst stationdb; /home/thl/.adnite2/stations.sqlite cloudsdx; 3; 3; 3; 3; 3; 3; 3; 3; 3 station; LOWG illum_outfilen; /home/thl/adnite2-work/LOWG/illum.csv ground; DRY; DRY; DRY; DRY; DRY; DRY; DRY; DRY; DRY .. warning:: In normal use you will never need to edit this files. Default parameter file ....................... A subset of a standard parameter file :file:`~/.adnite2/default.prm` is read to initialize the entry fields of program :program:`adnite2` at start. Wrong values can also cause a program crash here. :: cloudsdx; 3; 3; 3; 3; 3; 3; 3; 3; 3 ground; DRY; DRY; DRY; DRY; DRY; DRY; DRY; DRY; DRY groundx; WET; WET; WET; WET; WET; WET; WET; WET; WET cloudsnx; 10; 10; 10; 10; 10; 10; 10; 10; 10 station; LOWG cloudsn; 0; 0; 0; 0; 0; 0; 0; 0; 0 cloudsd; 0; 0; 0; 0; 0; 0; 0; 0; 0 times; 15:00; 17:00; 19:00; 21:00; 23:00; 01:00; 03:00; 05:00; 07:00