Log.xml - Revision history

Sfws at 08:22, 1 July 2021

2021-07-01T08:22:06Z

← Older revision		Revision as of 08:22, 1 July 2021
Line 1:		Line 1:

	File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.		File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.

			The file name is because Steve Loft originally had a screen "Station Log" to edit this file. As he wrote "It's (snow is) in the 'Log', which is an over-used term in Cumulus, I know. Select 'Log' from the 'View' menu.
			It is actually documented in the Help, under 'The Displays' - 'The Station Log Window'" in the forum "Wed 26 Nov 2008 10:08 am". Later it was renamed to "Weather diary" to overcome the confusion, it is not recorded which version implemented that change.

	== Content of file ==		== Content of file ==

Sfws at 11:06, 27 June 2021

2021-06-27T11:06:45Z

← Older revision		Revision as of 11:06, 27 June 2021
Line 1:		Line 1:
	= Introduction =

	File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.		File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.

Sfws: /* Editing this log = */ typo

2021-06-27T11:06:11Z

Editing this log =: typo

← Older revision		Revision as of 11:06, 27 June 2021
Line 22:		Line 22:
	</DATAPACKET></pre>		</DATAPACKET></pre>

	== Editing this log ===		== Editing this log ==
	The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited for reason explained earlier) using any XML viewer. However, most viewers (including your browser will struggle without a template telling them the complete format (not just what is shown above).		The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited for reason explained earlier) using any XML viewer. However, most viewers (including your browser will struggle without a template telling them the complete format (not just what is shown above).

Sfws: Corrected one link

2021-06-27T11:05:54Z

Corrected one link

← Older revision		Revision as of 11:05, 27 June 2021
Line 79:		Line 79:


	[[Category:~~Log~~ Files]]		[[Category:Cumulus Files]]
	[[Category:User Contributions]]		[[Category:User Contributions]]

Sfws: /* Content of file */

2020-05-31T19:36:20Z

Content of file

← Older revision		Revision as of 19:36, 31 May 2020
Line 5:		Line 5:
	== Content of file ==		== Content of file ==

	The structure Steve Loft created (and I think he regretted this later) is a bit more complicated than that shown below. Each <ROWDATA/> actually has another field not shown that is set by a somewhat complicated algorithm that I eventually worked out but will not fully describe here. Putting it as simply as I can, there is an extra code field, so that when an extra record is created for the same date, the code records how many times each individual field has been changed. Since any external XML editor does not understand this extra field, it cannot edit it, and without that field being correct the weather diary feature in Cumulus 1 cannot read it, and consequently will either not start or will crash out (depending on whether it is stopped or running at time of external edit).		The structure Steve Loft created (and I think he regretted this later) is a bit more complicated than that shown below. Each <ROWDATA/> actually has another field not shown that is set by a somewhat complicated algorithm that I eventually worked out but will not fully describe here. Putting it as simply as I can, there is an extra code field, so that when an extra record is created for the same date, the code records how many times each individual field has been changed (since it is tracking several fields, each of these has a different multiplier, so just a single number represents everything). Since any external XML editor does not understand this extra field, it cannot edit it, and without that field being correct the weather diary feature in Cumulus 1 cannot read it, and consequently will either not start or will crash out (depending on whether it is stopped or running at time of external edit).

	Here is the incomplete structure as detected by "XML Notepad 2007":		Here is the incomplete structure as detected by "XML Notepad 2007":

Sfws: /* Content of file */

2020-05-31T19:34:35Z

Content of file

← Older revision		Revision as of 19:34, 31 May 2020
Line 7:		Line 7:
	The structure Steve Loft created (and I think he regretted this later) is a bit more complicated than that shown below. Each <ROWDATA/> actually has another field not shown that is set by a somewhat complicated algorithm that I eventually worked out but will not fully describe here. Putting it as simply as I can, there is an extra code field, so that when an extra record is created for the same date, the code records how many times each individual field has been changed. Since any external XML editor does not understand this extra field, it cannot edit it, and without that field being correct the weather diary feature in Cumulus 1 cannot read it, and consequently will either not start or will crash out (depending on whether it is stopped or running at time of external edit).		The structure Steve Loft created (and I think he regretted this later) is a bit more complicated than that shown below. Each <ROWDATA/> actually has another field not shown that is set by a somewhat complicated algorithm that I eventually worked out but will not fully describe here. Putting it as simply as I can, there is an extra code field, so that when an extra record is created for the same date, the code records how many times each individual field has been changed. Since any external XML editor does not understand this extra field, it cannot edit it, and without that field being correct the weather diary feature in Cumulus 1 cannot read it, and consequently will either not start or will crash out (depending on whether it is stopped or running at time of external edit).

	Here is the structure as detected by "XML Notepad 2007":		Here is the incomplete structure as detected by "XML Notepad 2007":
	<pre><DATAPACKET Version="2.0">		<pre><DATAPACKET Version="2.0">
	<METADATA>		<METADATA>
Line 21:		Line 21:
	<ROWDATA/>		<ROWDATA/>
	</DATAPACKET></pre>		</DATAPACKET></pre>


	== Editing this log ===		== Editing this log ===

Sfws at 19:34, 31 May 2020

2020-05-31T19:34:16Z

@@ Line 1: / Line 1: @@
 File holding entries created in [[Weather_Diary|'Weather Diary']] assessed from Cumulus 1 View menu.
 == Editing this log ===
-The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited) using a XML viewer.
+The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited for reason explained earlier) using any XML viewer. However, most viewers (including your browser will struggle without a template telling them the complete format (not just what is shown above).
 == Using in your own scripts ==

Sfws: /* Using in your own scripts */

2020-05-31T17:36:40Z

Using in your own scripts

← Older revision		Revision as of 17:36, 31 May 2020
Line 59:		Line 59:

	[[Category:Log Files]]		[[Category:Log Files]]
			[[Category:User Contributions]]

Sfws at 17:35, 31 May 2020

2020-05-31T17:35:31Z

← Older revision		Revision as of 17:35, 31 May 2020
Line 1:		Line 1:
	File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.		File holding entries created in [[Weather_Diary\|'Weather Diary']] assessed from Cumulus 1 View menu.

			== Editing this log ===
	The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited) using a XML viewer.		The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited) using a XML viewer.

			== Using in your own scripts ==
⚫	~~This~~ is a piece of PHP code that can read this file and put what it reads (for a particular day) into PHP variables. Since this diary can hold several entries for the same day, a decision has to be made as to which to report. For snow falling, lying, and depth, this code saves the "worst case" of all the entries for that day. For the "entry" field, the one with latest time is retained.

	There is a web page using this code written by Czech author Miloš Jirík (https://pocasi.ok5aw.cz) available on the support forum at https://cumulus.hosiene.co.uk/viewtopic.php?p=83888#p83888		There is a web page using this code written by Czech author Miloš Jirík (https://pocasi.ok5aw.cz) available on the support forum at https://cumulus.hosiene.co.uk/viewtopic.php?p=83888#p83888 and that will display all the snow records on a web page.


		⚫	Taking that script as a starting point, the following code snippet is a piece of PHP code that can read this file and put what it reads (for onr particular day) into PHP variables. Since this diary can hold several entries for the same day, a decision has to be made as to which to report. For snow falling, lying, and depth, this code saves the "worst case" of all the entries for that day. For the "entry" field, the one with latest time is retained.

	<pre>		<pre>

Sfws at 17:32, 31 May 2020

2020-05-31T17:32:33Z

← Older revision		Revision as of 17:32, 31 May 2020
Line 16:		Line 16:
	echo 'ERROR - cannot access weather diary';		echo 'ERROR - cannot access weather diary';
	}else{		}else{
	if($debug) echo 'Success, database ' . $snowDiary . ' is open' . PHP_EOL;		if($debug) echo 'Success, database ' . $snowDiary . ' is open' . PHP_EOL;
	$data = fread($fh, filesize($snowDiary));		$data = fread($fh, filesize($snowDiary));
	fclose($fh);		fclose($fh); // close diary, now contents in $data
	$converted = iconv("Windows-1250", "UTF-8//IGNORE", $data);		$converted = iconv("Windows-1250", "UTF-8//IGNORE", $data); // Convert from windows format that Cumulus uses to UTF-8 to match what most scripts now use
	$xml = simplexml_load_string($converted);		$xml = simplexml_load_string($converted);
	$dayArray = array();		$dayArray = array();
	$oldKey = '';		$oldKey = '';
	foreach ($xml->xpath('//ROW') as $item)		foreach ($xml->xpath('//ROW') as $item)
	{		{
	$key = substr($item['EntryDate'],0,4) . '-' . substr($item['EntryDate'],4,2) . '-' . substr($item['EntryDate'],6,2);		$key = substr($item['EntryDate'],0,4) . '-' . substr($item['EntryDate'],4,2) . '-' . substr($item['EntryDate'],6,2);
	if($key > $rowMetDayStamp) break;		if($key > $rowMetDayStamp) break;
	$falling = $item['SnowFalling'] == 'TRUE' ? 1 : 0;		$falling = $item['SnowFalling'] == 'TRUE' ? 1 : 0;
	$lying = $item['SnowLying'] == 'TRUE' ? 1 : 0;		$lying = $item['SnowLying'] == 'TRUE' ? 1 : 0;
	$depth = $item['SnowDepth'];		$depth = $item['SnowDepth'];
	if($key == $oldKey) // update to another record for same day, retain worse boolean for falling and lying		if($key == $oldKey) // update to another record for same day, retain worse boolean for falling and lying
	{		{
	$falling = $oldFalling == 1 ? 1 : $falling;		$falling = $oldFalling == 1 ? 1 : $falling;
	$lying = $oldLying == 1 ? 1 : $lying;		$lying = $oldLying == 1 ? 1 : $lying;
	$depth = ($depth - $oldDepth) > 0 ? $depth : $oldDepth;		$depth = ($depth - $oldDepth) > 0 ? $depth : $oldDepth;
	}		}
	$Entry = $item['Entry'];		$Entry = $item['Entry'];
			$oldFalling = $falling;
	// novel to SPAWS
	$~~oldFalling~~ = $~~falling~~;		$oldLying = $lying;
	$~~oldLying~~ = $~~lying~~;		$oldDepth = $depth;
	~~$oldDepth~~ = $~~depth~~;		$oldKey = $key;
		⚫	} // end of loop through XML records
	$oldKey = $key;
		⚫	if($key == $rowMetDayStamp)
⚫	} // end of loop through XML records
			{
⚫	if($key == $rowMetDayStamp)
		⚫	$snowKnown = true;
	{
		⚫	goto snowDone;
⚫	$snowKnown = true;
			}
	if ($debug)
		⚫	$snowKnown = false;
	{
		⚫	$Entry = Null; // Other variables were previously set to values appropriate for the lowest temperature
	echo ' ----- Found entry in weather diary for ' . $englishProcessingDate . $lf;
		⚫	goto snowDone;
	}
⚫	goto snowDone;
	}
	if($debug) echo ' ----- NO entry in Cumulus 1 weather diary for ' . $englishProcessingDate . $lf . '============================' . $lf;
⚫	$snowKnown = false;
⚫	$Entry = Null; // Other variables were previously set to values appropriate for the lowest temperature
⚫	goto snowDone;
	}		}
	snowDone:</pre>		snowDone:</pre>