Feature Description¶

The DataScience feature Geo Presence Report focuses on the analysis of machines data in a given time frame and area, that is, performing analysis such as "Total Operating Hours" and "Fuel Consumption" on the identified machines.

Use Cases¶

Based on the defined geo area, reports can be created that show which machines are in the defined area and for how long.
A geo area can be e.g.a construction site in the form of a polygon, rectangle or circle.
The analysis supports customers in understanding (i.e. besides the regular invoices/paperwork) how the machines have been used in one or many construction sites.

Activation¶

The final product is the Geo Presence report in an Excel format that encompasses the sub-reports described in Analysis / Sub-Reports.
The report is sent via email.
To automatically generate the Geo Presence report, proceed as follows:

Activate the Geo Areas feature, see Add Geo Areas.
Set the organization properties like EMAIL and FREQUENCY, see Configuration parameters.

The script that generates the report runs on a daily basis at around 4 AM UTC.

Configuration¶

The geo areas are maintained via the REST API.
Proemion can set up a REST API endpoint for your organization and provide you the according documentation.
The parameters to be configured to fetch time series data are the following.

Note

The bucket size is automatically adjusted according to the Frequency property.

If it is below 7 days, the script pulls data using a bucket size of 2 minutes, otherwise 10 minutes.

Parameter	Values	Additional Information
feature.geo.key	feature.section.namedGeoAreas
isTenant	True
email (Org. Property)	property.custom.geo.report.email	Report receiver
frequency (Org. Property)	property.custom.geo.report.frequency.days	Time-range of the report / last number of days
last.issued (Org. Property)	property.custom.geo.report.last.issued	When the last report was issued
Signals	- value.common.machine.hours.operation.total	Standard metrics
	- value.common.engine.fuel.used.total
Aggregation	delta	Applied to both signals.

filter.skip.last.issued	False	Disable skip last issued filter
default.missing.value	0	Fill missing values with Zero
email	"Dear customer, \<br>\<br>	English language
	Your Geo Presence Report for the duration of <b>{{ frequency }}</b> days
	has been successfully completed and is attached in the Annex.<br><br>
	This is an automatically generated email.
	If you have any questions, please reach out
	to your contact person.<br><br>"

Create a Geo Presence Report¶

Add Geo Areas¶

In order to get the Geo Presence Report, you must add its Geo Areas using the Geo Areas UI in the DataPortal, see Geo Areas.
The script automatically reads the Geo Areas and processes the data.
You must provide the following beforehand:

E-mail: the report is sent to the email that is informed by the customer.
Frequency: Number of days to process the data, that is, Proemion generates the report based on the last n-days activity.

Detect Machine Presence¶

In order to detect machine presence in a given construction site and time frame, the Geo Areas along with a time frame have to be passed as parameters to the REST API that returns a list of machines within the given area and time frame.

Analysis / Sub-Reports¶

After identifying all machines within an area and time frame, Proemion then performs the following analysis:

Total/Average Duration of the machine(s).
Total Operating Hours in the area/time.
Total Fuel Consumption in the area/time.
The number of Geo Data Points.
The number of Daily Time-Series Data Points (i.e.only for Daily Breakdown).
The analysis consists of four parts that are described as follows:
Summary Geolocation: summarizes all the aforementioned analyses per construction site.
Presences - Activity per Site: shows all machine activities, that is, the same machine might have many activities on the same construction site, but on different days.
Presences - Total per Machine: machine presence is summarized for the whole time frame.
Proemion see only one instance of a machine.