Download the PHP package duckfusion/waddle without Composer
On this page you can find all versions of the php package duckfusion/waddle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package waddle
Waddle
Waddle is a PHP library for parsing GPS activities (e.g. from a Sports Watch) and calculating various metrics. It supports the parsing of .TCX, .GPX, .PWX and .CSV files.
Installation
via Composer
via Zip file
Download the Waddle zip file from this repository and place inside your project. You will then need to require or include the files you wish to use, unless you are making use of an autoloader.
Example Usage
This will parse the .tcx file and load the Activity into the $activity variable, which can then be used to calculate metrics:
Available Parsers
All parsers just have the one method you need to call, passing in the path to your relevant file, as seen in earlier examples. This method returns an instance of the Activity class (or throws an exception upon failure). This Activity object can then be used to calculate all the different metrics based on the file contents.
Available Activity Metrics/Data
-
This returns the type of activity, e.g. "Running" or "Cycling"
-
This returns the start time of the activity. The variable should contain a valid data format
-
This returns the total distance of the activity, in metres.
-
This returns the total duration of the activity, in seconds.
-
This returns the average pace per mile of the activity, in the format "hh:mm:ss".
-
This returns the average pace per kilometre of the activity, in the format "hh:mm:ss".
-
This returns the average speed of the activity, in miles per hour.
-
This returns the average speed of the activity, in kilometres per hour.
-
This returns the total calories burned in the activity (if this was specified in the file).
-
This returns the maximum speed of the activity, in miles per hour.
-
This returns the maximum speed of the activity, in kilometres per hour.
-
This returns an array with the total distance ascended and decended, in metres.
- This retrurns an array of the activity splits. The variable should contain either "m" for miles, or "k" for kilometres. The activity will then be split into 1 mile/kilometre points. Future - In the future this will split into mini Activity objects, so metrics can be calculated on individual splits as well.
Differences Between The Parsers
Some file formats contain more information than others. For example, a standard .TCX or .PWX file contains summary information at the top, with the Total Duration of the activity, the Total Distance, etc... Whereas formats such as .CSV and .GPX do not, so this information is calculated by the Parser. As such you may find slight differences between the results of the Parsers.
Converting Metrics Between Formats
By default some metrics are calculated in unhelpful measures, such as Total Distance being in metres, when you might want a more helpful measure, such as miles or kilometres.
You can use the Converter class to convert between formats:
-
This converts a metres per second value, into miles per hour.
-
This converts a metres per second value, into kilometres per hour.
-
This converts a metres value, into kilometres.
-
This converts a metres value, into miles.
-
This converts a metres value, into feet.
-
This converts a miles value, into metres.
-
This converts a kilometres value, into metres.
-
This converts the values of hours, minutes and seconds, into a decimal hour value. For example, 2 hours, 45 minutes and 0 seconds, would be converted to a decimal "2.75" hours.
-
This converts a seconds value, into the format "hh:mm:ss".
- This converts a string with the format "hh:mm:ss", into seconds.
Extras - Calculators
In addition to the calculations available on the Activity class, there are also extra Calculator classes you can use to calculate data not included in the GPS activity file, such as Calories burned.
CalorieCalculator
The CalorieCalculator class uses MET (Metabolic Equivilent) scores to calculate how many calories are burned, based on the intensity of the activity and the weight of the person.
It should be noted that calorie calculations can vary quite wildly between different systems and should only ever be used as a rough estimate, as there are many things which can affect how quickly an individual burns calories.
Available methods
-
This calculates the rough MET score of a Running activity, based on the average speed in miles per hour.
-
This calculates the rough MET score of a Running activity, based on the average speed in kilometres per hour.
- This calculates the rough Calories burned, based on the MET score of the activity, the weight of the person in kilograms, and the duration of the activity, in decimal time.
Examples
Help
If you need any help with Waddle, just raise an issue describing the problem.
