##########################################################################################

       GPXIN-26: Calculate Min/Max Lat and Lon and add to Stats

##########################################################################################


Issue Type: New Feature 
-----------------------------------------------------------------------------------------

Issue Information
====================

Priority: Minor					Status:      Closed
Resolution:  Done (2016-02-20 20:53:31)
Project: PHP GPXIngest (GPXIN)


Reported By: btasker					
Assigned To: btasker


Affected Versions:		
	- 1.02  			


Targeted for fix in version: 
	- 1.02


Time Estimate: 0 minutes
Time Logged:   32 minutes


-----------------------------------------------------------------------------------------

Issue Description
==================

Requested on Github as #7

Add new stats indicating the highest and lowest lat/lon pairs seen.



-----------------------------------------------------------------------------------------

Issue Relations
================
	
	- Github FR #7 (https://github.com/bentasker/PHP-GPX-Ingest/issues/7)



-----------------------------------------------------------------------------------------

Activity
==========

	
-----------------------------------------------------------------------------------------
2016-02-20 19:37:11              btasker
-----------------------------------------------------------------------------------------

Need to know more about the use-case the user has in mind, do they want the actual
coordinates for max/min (so an actual lat/lon pair) or are they simply interested in
extracting the maximum/minimum recorded latitude - essentially meaning those stats
properties will simply be decimal.

One option might be to make the relevant stats property an object in itself, so we'd have
something like

-- BEGIN SNIPPET --

$stats->maxLon->Lon = 1234
$stats->maxLon->Lat = 4567
$stats->maxLat->Lon = 1134
$stats->maxLat->Lat = 5567

 -- END SNIPPET --

Which would give the option of either, but then when retrieving it you'd have to do
something like

-- BEGIN SNIPPET --

$foo = $o->getStats('MaxLon');
echo $foo->Lon;

 -- END SNIPPET --
Which feels a bit ugly and un-necessary

	
-----------------------------------------------------------------------------------------
2016-02-20 19:40:32              
-----------------------------------------------------------------------------------------

btasker changed priority from '[issuelistpty 3]Major[/issuelistpty]' to '[issuelistpty
4]Minor[/issuelistpty]'
	
-----------------------------------------------------------------------------------------
2016-02-20 19:49:57              btasker
-----------------------------------------------------------------------------------------

The user has said they need square bounds on a per-file, per-track and per-segment basis.
Makes sense, it'd allow you (for example) to easily extract the bounds to pass into Google
Maps to ensure it's correctly centred around the track you're displaying.
	
-----------------------------------------------------------------------------------------
2016-02-20 19:51:08              
-----------------------------------------------------------------------------------------

btasker changed status from 'Open' to 'In Progress'
	
-----------------------------------------------------------------------------------------
2016-02-20 20:17:09              btasker
-----------------------------------------------------------------------------------------

Commit _6d9e313_ implements bounds calculations for the overall file, and also on a
per-segment basis, so we just need to calculate per-track now.
	
-----------------------------------------------------------------------------------------
2016-02-20 20:17:17              
-----------------------------------------------------------------------------------------

btasker changed status from 'In Progress' to 'Open'
	
-----------------------------------------------------------------------------------------
2016-02-20 20:17:30              git
-----------------------------------------------------------------------------------------


-- BEGIN QUOTE --


Repo: PHP-GPX-Ingest
Commit: 6d9e3135c22739399d46bd75f8a488da26455a72
Author: B Tasker <github@<Domain Hidden>>

Date: Sat Feb 20 20:16:13 2016 +0000
Commit Message: Implemented Segment and overall lat/lon bounds for GPXIN-26



Modified (-)(+)
-------
GPXIngest.class.php



-- END QUOTE --

*Webhook User-Agent*


-- BEGIN SNIPPET --

GitHub-Hookshot/21f57ba
 -- END SNIPPET --

https://github.com/bentasker/PHP-GPX-Ingest/commit/6d9e3135c22739399d46bd75f8a488da26455a72


	
-----------------------------------------------------------------------------------------
2016-02-20 20:17:32              
-----------------------------------------------------------------------------------------

btasker changed timespent from '0 minutes' to '26 minutes'
	
-----------------------------------------------------------------------------------------
2016-02-20 20:31:50              btasker
-----------------------------------------------------------------------------------------

We now have a _bounds_ object within the stats for 
- the entire file
- each track
- each segment

Running a _print\_r()_ on each gives

-- BEGIN SNIPPET --

gpx->getJourneyStats()
stdClass Object
(
    [trackpoints] => 778
    [recordedDuration] => 7556
    [segments] => 16
    [tracks] => 16
    [maxacceleration] => 0
    [maxdeceleration] => 0
    [minacceleration] => 0
    [mindeceleration] => 0
    [avgacceleration] => 0
    [avgdeceleration] => 0
    [speedUoM] => Array
        (
        )

    [timeMoving] => 0
    [timeStationary] => 0
    [timeAccelerating] => 0
    [timeDecelerating] => 0
    [distanceTravelled] => 0
    [bounds] => stdClass Object
        (
            [Lat] => stdClass Object
                (
                    [min] => 56.114105
                    [max] => 56.179494
                )

            [Lon] => stdClass Object
                (
                    [min] => 43.346461
                    [max] => 43.522420
                )

        )

    [start] => 1368860043
    [end] => 1368888867
)

gpx->getStats('journey0')
stdClass Object
(
    [journeyDuration] => 1562
    [maxacceleration] => 0
    [maxdeceleration] => 0
    [minacceleration] => 0
    [mindeceleration] => 0
    [avgacceleration] => 0
    [avgdeceleration] => 0
    [speedUoM] => Array
        (
        )

    [timeMoving] => 0
    [timeStationary] => 0
    [timeAccelerating] => 0
    [timeDecelerating] => 0
    [distanceTravelled] => 0
    [bounds] => stdClass Object
        (
            [Lat] => stdClass Object
                (
                    [min] => 56.114105
                    [max] => 56.119712
                )

            [Lon] => stdClass Object
                (
                    [min] => 43.503630
                    [max] => 43.522420
                )

        )

    [start] => 1368860043
    [end] => 1368861605
    [recordedDuration] => 1562
    [elevation] => stdClass Object
        (
            [max] => 129.22
            [min] => 60.83
            [avgChange] => 0.38
        )

)

gpx->getStats('journey0','seg0')
stdClass Object
(
    [distanceTravelled] => 0
    [bounds] => stdClass Object
        (
            [Lat] => stdClass Object
                (
                    [min] => 56.114105
                    [max] => 56.119712
                )

            [Lon] => stdClass Object
                (
                    [min] => 43.503630
                    [max] => 43.522420
                )

        )

    [start] => 1368860043
    [end] => 1368861605
    [journeyDuration] => 1562
    [elevation] => stdClass Object
        (
            [max] => 129.22
            [min] => 60.83
            [avgChange] => 0.38
        )

    [timeMoving] => 0
    [timeStationary] => 0
    [timeAccelerating] => 0
    [timeDecelerating] => 0
)

 -- END SNIPPET --
	
-----------------------------------------------------------------------------------------
2016-02-20 20:32:57              
-----------------------------------------------------------------------------------------

btasker changed timespent from '26 minutes' to '32 minutes'
	
-----------------------------------------------------------------------------------------
2016-02-20 20:33:29              git
-----------------------------------------------------------------------------------------


-- BEGIN QUOTE --


Repo: PHP-GPX-Ingest
Commit: 04babac1c2d31af1dc9dcb271601258a0c8128ff
Author: B Tasker <github@<Domain Hidden>>

Date: Sat Feb 20 20:32:26 2016 +0000
Commit Message: Added per track lat/lon bounds for GPXIN-26 (FR #7)



Modified (-)(+)
-------
GPXIngest.class.php



-- END QUOTE --

*Webhook User-Agent*


-- BEGIN SNIPPET --

GitHub-Hookshot/21f57ba
 -- END SNIPPET --

https://github.com/bentasker/PHP-GPX-Ingest/commit/04babac1c2d31af1dc9dcb271601258a0c8128ff


	
-----------------------------------------------------------------------------------------
2016-02-20 20:53:18              btasker
-----------------------------------------------------------------------------------------

I've updated the documentation
(https://www.bentasker.co.uk/documentation/development-programming/222-php-gpx-ingest) to
reflect the change to the stats objects
	
-----------------------------------------------------------------------------------------
2016-02-20 20:53:31              
-----------------------------------------------------------------------------------------

btasker changed status from 'Open' to 'Resolved'
	
-----------------------------------------------------------------------------------------
2016-02-20 20:53:31              
-----------------------------------------------------------------------------------------

btasker added 'Done' to resolution
	
-----------------------------------------------------------------------------------------
2016-02-20 20:53:35              
-----------------------------------------------------------------------------------------

btasker changed status from 'Resolved' to 'Closed'


-----------------------------------------------------------------------------------------

Worklog
========

 
-----------------------------------------------------------------------------------------
2016-02-20 20:17:32              btasker

26 minutes
-----------------------------------------------------------------------------------------

Initial implementation and testing
 
-----------------------------------------------------------------------------------------
2016-02-20 20:32:57              btasker

6 minutes
-----------------------------------------------------------------------------------------

Implementing per-track stats and testing