Dayfile.txt: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search

Dayfile.txt (view source)

Revision as of 08:38, 25 May 2020

3,177 bytes added ,  08:38, 25 May 2020
m
→‎List of fields in the file
Line 257: Line 257:




==List of fields in the file==
== List of fields in dayfile.txt ==
'''The appropriate list of fields for your installed build is stored as ''dayfileheader.txt'' within the folder that contains your Cumulus executable.'''


Listed below is the field number (starting from zero to be consistent with index used for arrays in programming languages like JavaScript, plus spreadsheet column identifier) with description and cross-references to further explanation:
=== Variation by Cumulus version ===
* 00 (A): Date as  ''2 figure day [separator] 2 figure month [separator] 2 figure year'' - the separator is that set in the windows system short date format (see [[setup]])
* 01 (B): Highest wind [[Wind_measurement#Weather_Stations_and_Cumulus|gust]]
* 02 (C): [[Wind_measurement#Wind_Direction | Bearing]] of highest wind gust (integer)
* 03 (D): Time of highest wind gust
* 04 (E): Minimum [[Temperature_(and_humidity)_measurement#Cumulus_Calculated_Parameters | temperature]]
* 05 (F): Time of minimum temperature
* 06 (G): Maximum temperature
* 07 (H): Time of maximum temperature
* 08 (I): Minimum [[Pressure_Measurement | sea level pressure]]
* 09 (J): Time of minimum pressure
* 10 (K): Maximum sea level pressure
* 11 (L): Time of maximum pressure
* 12 (M): Maximum [[Rain_measurement#Rain_Rate | rainfall rate]]
* 13 (N): Time of maximum rainfall rate
* 14 (O): Total rainfall for the day
(This point represents the minimum length of all records)
* 15 (P): [[Average temperature]] for the day
* 16 (Q): Total [[Windrun | wind run]]
(The last two entries were added from v 1.8.9 build 907)
* 17 (R): Highest [[Wind_measurement#Weather_Stations_and_Cumulus|Average Wind Speed]]
* 18 (S): Time of Highest Avg. Wind speed
(Those two entries were added from v 1.9.0)
* 19 (T): Lowest [[Temperature_(and_humidity)_measurement | humidity]] (integer)
* 20 (U): Time of lowest humidity
* 21 (V): Highest humidity (integer)
* 22 (W): Time of highest humidity
* 23 (X): Total evapotranspiration (Only valid for Davis stations, shows zero otherwise)
* 24 (Y): Total hours of sunshine (only valid if sunshine sensor connnected)
* 25 (Z): High [[Heat index]]
* 26 (AA): Time of high heat index
* 27 (AB): High [[Apparent temperature]]
* 28 (AC): Time of high apparent temperature
* 29 (AD): Low apparent temperature
* 30 (AE): Time of low apparent temperature
* 31 (AF): High hourly rain
* 32 (AG): Time of high hourly rain
* 33 (AH): Low [[wind chill]]
* 34 (AI): Time of low wind chill
(The last 16 entries were added in version 1.9.1)
* 35 (AJ): High [[Temperature_(and_humidity)_measurement#Cumulus_Calculated_Parameters | dew point]]
* 36 (AK): Time of high dew point
* 37 (AL): Low dew point
* 38 (AM): Time of low dew point
(Last 4 entries added in version 1.9.2 beta build)
* 39 (AN): Today's dominant/average wind direction (integer)
* 40 (AO): [[Heat/cold degree days and Chill hours | Heating degree days]]
* 41 (AP): [[Heat/cold degree days and Chill hours | Cooling degree days]]
(These last three entries were added from 1.9.2 Build 1004)


Next, added in version 1.9.3 build 1036 (these only show valid values if appropriate sensors exist)
The dayfile.txt has grown as Cumulus's functionality has been extended, the table below shows fields grouped by the Cumulus version when those fields were added.  
* 42 (AQ): High solar radiation
* 43 (AR): Time of high solar radiation
* 44 (AS): High UV Index
* 45 (AT): Time of high UV Index


Later added in version 3.6.0, 2 more derived values
If you have been using Cumulus for a while, then some lines will be shorter than others, the number of fields per line growing when a new release adds new fields, Cumulus does not in normal operation modify earlier lines, but both Cumulus 1 and MX provide editors where it is possible to modify any line.
* 46 (AU): High [[Feels Like]] temperature
* 47 (AV): Time of high feels like temperature
* 48 (AW): Low Feels Like temperature
* 49 (AX): Time of low feels like temperature


(Cumulus MX uses all fields as listed above)
There is information earlier in this article about how you might be able to recalculate values to put in for fields that did not exist when any particular line was created.
 
'''For your installed build please see ''dayfileheader.txt'' (stored within the folder that contains your Cumulus executable), as that will list which fields are available for you.'''
 
=== Information shown in the table ===
 
*The field number is shown starting from zero, this has two advantages:
**It stresses that the line consists of a date, (that should be a unique identifier, the same date should not be repeated in another line) plus data (mostly numerical, but some values are paired with a time)
**Numbering starting from zero is consistent with standard indexing used for arrays in programming languages (like JavaScript), so the number shown is the number to quote in any scripts you write to read this file if you just want to examine that particular derivative.
*The alphabetic column identifiers used by many spreadsheets are shown, please see warnings about using spreadsheets for editing earlier on this page
*The type of field is shown, you must not put a sign for an unsigned field, you can not specify a decimal point in an integer field, all time fields must use HH:mm format
*The field description is shown, together with references to where that terminology is explained
 
=== List of Fields ===
{| class="wikitable" border="1"
|-
!style="width:50px" | Field number
!style="width:50px" | Spreadsheet column
!style="width:60px" | Field type
!style="width:600px" | Description
|-
|colspan="4" style="background:lightgray;"|Included from when dayfile.txt first invented
|-
|0
|A
|8 characters
|Date as ''2 figure day [separator] 2 figure month [separator] 2 figure year'' - the separator is that set in the windows system short date format (see [[setup]])
|-
|1
|B
|Unsigned number
|Highest wind [[Wind_measurement#Weather_Stations_and_Cumulus|gust]] speed
|-
|2
|C
|unsigned integer
|[[Wind_measurement#Wind_Direction | Bearing]] of highest wind gust
|-
|3
|D
|5 characters
|Time of highest wind gust
|-
|4
|E
|signed decimal
|Minimum [[Temperature_(and_humidity)_measurement#Cumulus_Calculated_Parameters | temperature]]
|-
|5
|F
|5 characters
|Time of minimum temperature
|-
|6
|G
|signed decimal
|Maximum temperature
|-
|7
|H
|5 characters
|Time of maximum temperature
|-
|8
|I
|Unsigned number
|Minimum [[Pressure_Measurement | sea level pressure]]
|-
|9
|J
|5 characters
|Time of minimum pressure
|-
|10
|K
|Unsigned number
|Maximum sea level pressure
|-
|11
|L
|5 characters
|Time of maximum pressure
|-
|12
|M
|unsigned number
|Maximum [[Rain_measurement#Rain_Rate | rainfall rate]]
|-
|13
|N
|5 characters
|Time of maximum rainfall rate
|-
|14
|O
|unsigned number
|Total rainfall for the day
|-
|colspan="4" style="background:lightgray;"|(This point represents the minimum length of all records)
|-
|15
|P
|signed decimal
|[[Average temperature]] for the day
|-
|colspan="4" style="background:lightgray;"|(The next entry was added from v 1.8.9 in build 907)
|-
|1
|Q
|unsigned number
|Daily [[Windrun | wind run]]
|-
|colspan="4" style="background:lightgray;"|(The next pair of entries were added from v 1.8.9)
|17
|R
|unsigned number
|Highest [[Wind_measurement#Weather_Stations_and_Cumulus|Average Wind Speed]]
|-
|18
|S
|5 characters
|Time of Highest Avg. Wind speed
|-
|colspan="4" style="background:lightgray;"|(The next two pairs of entries were added from v 1.9.0)
|-
|19
|T
|unsigned integer
|Lowest [[Temperature_(and_humidity)_measurement | humidity]]
|-
|20
|U
|5 characters
|Time of lowest humidity
|-
|21
|V
|unsigned integer
|Highest humidity
|-
|22
|W
|5 characters
|Time of highest humidity
|-
|colspan="4" style="background:lightgray;"|(The next two entries were added from v 1.9.0)
|-
|23
|X
|(not documented)
|Total evapotranspiration (Only valid for Davis stations, shows zero otherwise)
|-
|24
|Y
|unsigned
|Total hours of sunshine (only valid if sunshine sensor connected)
|-
|colspan="4" style="background:lightgray;"|(The next 16 entries were added from v 1.9.1)
|-
|25
|Z
|signed decimal
|High [[Heat index]]
|-
|26
|AA
|5 characters
|Time of high heat index
|-
|27
|AB
|Signed decimal
|High [[Apparent temperature]]
|-
|28
|AC
|5 characters
|Time of high apparent temperature
|-
|29
|AD
|signed decimal
|Low apparent temperature
|-
|30
|AE
|5 characters
|Time of low apparent temperature
|-
|31
|AF
|unsigned number
|High hourly rain
|-
|32
|AG
|5 characters
|Time of high hourly rain
|-
|33
|AH)
|signed decimal
|Greatest [[wind chill]] (high wind speed, low temperature)
|-
|34
|AI
|5 characters
|Time of greatest wind chill
|-
|colspan="4" style="background:lightgray;"|(The next two pairs were added in version 1.9.2 beta build)
|-
|35
|AJ
|signed decimal
|High [[Temperature_(and_humidity)_measurement#Cumulus_Calculated_Parameters | dew point]]
|-
|36
|AK
|5 characters
|Time of high dew point
|-
|37
|AL
|signed decimal
|Low dew point
|-
|38
|AM)
|5 characters
|Time of low dew point
|-
|colspan="4" style="background:lightgray;"|(The next three entries were added in version 1.9.2 Build 1004)
|-
|39
|AN
|unsigned integer
|Today's dominant/average wind direction
|-
|40
|AO
|unsigned decimal
|[[Heat/cold degree days and Chill hours | Heating degree days]]
|-
|41
|AP
|unsigned decimal
|[[Heat/cold degree days and Chill hours | Cooling degree days]]
|-
|colspan="4" style="background:lightgray;"|The next two pairs were added in version 1.9.3 build 1036 (these only show valid values if appropriate sensors exist)
|-
|42
|AQ
|unsigned decimal
|High solar radiation
|-
|43
|AR
|5 characters
|Time of high solar radiation
|-
|44
|AS
|unsigned decimal
|High UV Index
|-
|45
|AT
|5 characters
|Time of high UV Index
|-
|colspan="4" style="background:lightgray;"|The next two pairs were added in version 3.6.0, 2 more derived values
|-
|46
|AU
|signed decimal
|High [[Feels Like]] temperature
|-
|47
|AV
|5 characters
|Time of high feels like temperature
|-
|48
|AW
|signed decimal
|Low Feels Like temperature
|-
|49
|AX
|5 characters
|Time of low feels like temperature
|}


==Example of the file==
==Example of the file==
Sfws
5,838

edits

Retrieved from "https://www.cumuluswiki.org/a/Special:MobileDiff/5836"

Navigation menu