5,838
edits
Dayfile.txt: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m
→List of fields in the file
|
== List of fields in
=== Variation by Cumulus version ===
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.
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.
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==
| |||
