3. System files and and directories

3.1. Configuration directory

The configuration directory is a “hidden” Unix/Linux-directory below the users home directory: ~/.adnite2/.

  • Sub directories:

    • .adnite2/doc/

      Contains the html documentation starting with ~/.adnite2/doc/index.html

    • ~/.adnite2/logfiles/

      Contains logfiles of the different session

    • ~/.adnite2/logo/

      Contains the program logo in different resolutions

  • Files:

    • ~/.adnite2/default.cfg

      Main configuration file, see below.

    • ~/.adnite2/template.rst

      RestructuredText template: contains the invariant part of the output form sheed and has instruction to iclude the variant tables and images.

    • ~/./adnite2/default.prm

      Default parameter file for the default filling of the adnite2-gui.

    • ~/./adnite2/default.css

      CSS-file for the html-putput. This special css has been borrowed from the Sphinx project theming support, forgotten which one :-)

    • ~/./adnite2/default.sheet

      Style sheet for the pdf-output, taken from the rst2pdf project.

3.1.1. Configuration file

Configuration 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.

# 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 ~/.adnite2/default.cfg unless you know what you are doing. A corrupted configuration file means program crash.

3.2. Parameter file

The parameter file is written by the graphical user interface adnite2 to the outputdirectory (= workdirectory + ‘/’ + station), e.g. /home/thl/uCloud/test/adnite2-wx/LOWG and contains all information to be run by 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.

3.2.1. Default parameter file

A subset of a standard parameter file ~/.adnite2/default.prm is read to initialize the entry fields of 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