INI Commentary

This page presents an example INI file for Photizo, and documents that to which the various parts refer.

[Main]
# Used mainly in diagnostic pages and the like
networkDescriptiveName = Alaska Department of Transportation
# Used internally for file locations
networkName = adot
# Where are the config files
configDir = /home/jkugler/programming/photizo/misc/dot
# Where are the template files (could be different locations)
templateDir = /home/jkugler/programming/photizo/misc/dot/
# The base dir for rendered files
outputDirBase = /home/jkugler/tmp/pds
# Base URL of the data files (http://, ftp://, file:///home/data, etc)
# This URL includes the data file type plus "retrieval type:" HTTP, local files, etc.
sourceFileBaseURL = toa5+file:///home/jkugler/ln-data/adot
# The storage type and location
dataStoreBaseURL = bdbpack:///home/jkugler/tmp/pds
# Name of the diagnostics files
diagOutputName = adot-diag.html
# Are we generating the "stripped down" include files?
generateInclude = True
# Where are the graphs going?
graphOutputDirBase = /home/jkugler/tmp/pds
diagURL = http://www.eeinternet.com/dot/html/adot-diag.html

[DataRecency]
# When, and to whom, are the notify e-mails sent? (Not currently implemented)
threshold = 0.25
notifyEmail = user@somehost.com

[StationOrder]
# Used mainly for ordering and grouping stations on the diag pages
baseStationOrder = bullen,foothills

  [[bullen]]
  baseStationName = Bullen Point Project
  stationOrder = DBM1,DBM2,DBM3,DBM4,DBM5,DBM6,DBM7,DBM8,DBR1,DBR2,DBR3,DBR4,DBR5

  [[foothills]]
  baseStationName = Kuparuk Foothills Project
  stationOrder = DFM1,DFM2,DFM3,DFM4,DFM5,DFR1,DFR2,DFR3

[Stations]

  [[DBM2]]
  #Informational Only #
  PakbusID = 202
  StationDescriptiveName = Ribdon Met
  StationLocationDescription = Upper Rubicon
  Latitude = 68 38.548
  Longitude = -147 21.107
  MagneticDeclination = 23.1
  ElevationFt = 4648
  ElevationM = 1417.64
  # End Informational Only #
  # In what directory under the base directory does this station have its source data files?
  DataFileDirectory =
  # Common prefix for all source data file names
  DataFileNameBase = DBM2_
  # The suffixes (after the common prefix) for all the files to import
  ImportDataFileSuffixes = Daily.dat,DailyRaw.dat,HrlyAtms.dat,HrlyDiag.dat,HrlyRaw.dat,HrlySubs.dat,TwoMinWd.dat
  # The suffixes of the files to use for conditions reporting
  CurrentConditionsDataFileSuffixes = HrlyAtms.dat,HrlyDiag.dat,HrlySubs.dat
  # In what dir, under the base output dir, will the conditions page be put?
  OutputDir = DBM2
  # Which column map to use (see below)
  ColumnMap = dot
  # Which columns to ignore in the source data files
  # I.e. a value of '3' will ignore the first three columns when importing
  ColumnOffset=3
  # Graphs to generate for this station
  Graphs = Air,Wind,Diagnostics

[ColumnMaps]

  [[dot]]
  # Format of the lines is as follows:
  # The left hand side is the name of the data point in the source data file
  # On the right hand side:
  #  common_name: the name used in conditions and diag pages, and graphing
  #  comment: aka description; used in legends in graphs
  #  type: used as a hint for storage engines which store the data in a binary format
  TIMESTAMP = common_name:timeStamp,
  WindSpeed_WVc(1) = common_name:windSpeedAvg,comment:Avg Wind Speed,type:float
  WindSpeed_WVc(2) = common_name:windDirection,comment:Wind Direction,type:float
  WindSpeed_Max = common_name:windSpeedMax,comment:Max Wind Speed,type:float
  batt_volt_Avg = common_name:batteryVoltage,comment:Battery Voltage,type:float
  SolarPnlV_Avg = common_name:solarPanelVoltageAvg,comment:Avg Solar Panel Voltage,type:float
  PanelT = common_name:panelTemp,comment:Panel Temperature,type:float
  CRNT_AT_Avg = common_name:airTempAvg,comment:Avg Air Temperature,type:float
  CRNT_RH_Avg = common_name:relativeHumidityAvg,comment:Avg Relative Humidity,type:float
  CRNT_DP_Avg = common_name:dewTempAvg,comment:Avg Dew Point,type:float
  Precip_Tot = common_name:totalPrecipitation,comment:Total Precipitation,type:float
  SnowDepth_Avg = common_name:snowDepthAvg,comment:Avg Snow Depth,type:float
  Therm_degC(1) = common_name:soilSurfaceTemp,comment:Soil Surface Temperature,type:float
  Therm_degC(4) = common_name:soilProfileSurface,comment:0 cm,type:float
  Therm_degC(5) = common_name:soilProfileOne,comment:5 cm,type:float
  Therm_degC(6) = common_name:soilProfileTwo,comment:10 cm,type:float
  Therm_degC(7) = common_name:soilProfileThree,comment:15 cm,type:float
  Therm_degC(8) = common_name:soilProfileFour,comment:20 cm,type:float
  Therm_degC(9) = common_name:soilProfileFive,comment:40 cm,type:float
  Soil_Moisture_1 = common_name:SoilMoistureOne,comment:5 cm,type:float
  Soil_Moisture_2 = common_name:SoilMoistureTwo,comment:20 cm,type:float
  Soil_Moisture_3 = common_name:SoilMoistureThree,comment:40 cm,type:float

# Defines the Figures (and the graphs that go on each figure)
[GraphDefs]
  [[Air]]
    # output file name
    fileName = air
    [[[Graphs]]]
      [[[[Air_Temperature]]]]
        # What type of graph (in this case, temperature)
        graphType = T
        # What sensors to include in the graph
        sensors = airTempAvg,
      [[[[Relative_Humidity]]]]
        graphType = RH
        sensors = relativeHumidityAvg,

  [[Wind]]
    fileName = wind
    [[[Graphs]]]
      [[[[Wind_Speed]]]]
        graphType = WS
        sensors = windSpeedAvg,
      [[[[Wind_Direction]]]]
        graphType = WD
        sensors = windDirection,

  [[Diagnostics]]
    fileName = diag
    [[[Graphs]]]
      [[[[Panel_Temperature]]]]
        graphType = T
        sensors = panelTemp,
      [[[[Battery_Voltage]]]]
        graphType = V
        sensors = batteryVoltage,

(:notoc:)