Recent Changes - Search:

Project Status

Project Documents

Discussion

Bug Tracking

edit SideBar

INICommentary

INI Commentary

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

[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 (condition pages)
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 = sqob:///home/jkugler/photizo/data
# 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]
# Threshold set to notify user(s) once the latest reading is 6 hours old.
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

# You can define virtual sensors if the sensor readings need to be offset 
# to account for the location of the sensor

    [[[VirtualSensors]]]
      [[[[lakeLevel1_ADJ]]]]
        type = offset
        sensor = lakeLevel1
        comment = Lake Level Above Sea Level - PT Sensor 1
      [[[[lakeLevel2_ADJ]]]]
        type = offset
        sensor = lakeLevel2
        comment = Lake Level Above Sea Level - PT Sensor 2

# The amount of offset must be defined in a separate file (one per sensor), 
# example: L9312#lakeLevel1.offset
# Format of the offset file: DateStart,DateEnd,Offset
# Example: 2009-11-01 00:00:00,PRESENT,0.1312


[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) - a figure can have one or two graphs
# The graph types define the scale used on the (left) vertical axis of the graph (found in BaseGraph.py)
# There can be more than one sensor per graph, as long as the units of measurement are the same

[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,

# Graphs showing sensor and virtual sensor output
# Note: commas at the end of the sensors list are optional (no longer required)

  [[Water_Level]]
  fileName = water_level
  title = "$station: Water Level Above Sensors"
    [[[Graphs]]]
      [[[[Water_Level]]]]
        graphType = WL
        graphUnits = foot
        sensors = lakeLevel1,lakeLevel2

  [[Water_Level_Adj]]
  fileName = water_level_adj
  title = "$station: Water Level Above Sea Level"
    [[[Graphs]]]
      [[[[Water_Level]]]]
        graphType = WL
        graphUnits = foot
        sensors = lakeLevel1_ADJ,lakeLevel2_ADJ

# You can create graphs that plot sensor outputs from different stations
# as long as the units of measure are the same, example:

[MultiStationGraphs]

    [[AirCompare]]
      fileName = air_compare
      title = "L9312 versus L9817 Air Temperatures"
        [[[Graphs]]]
           [[[[AirCompare]]]]
               graphType = T
               sensors = L9312.airTempAvg,L9817.airTempAvg
               lineColors = blue,green
               stationInLegend = False



(:notoc:)

Edit - History - Print - Recent Changes - Search
Page last modified on April 06, 2010, at 09:22 PM