Python Offline Processing Tutorial

On-Premise

PREMIUM

ENTERPRISE

BESPOKE

Price

$499 / YEAR

$999 / YEAR

POA

No. of Combinations

> 720,000

> 910,000

No. of Properties

> 130

> 210

No. of Detections

Unlimited

No. of Websites

Unlimited

Updates

Weekly

Daily

Support

Forum Support

SLA

Unlimited Servers

Yes

Unlimited Analytics

Yes

TRIAL BUY

QUOTE

Cloud

LITE

PREMIUM

Price

FREE

$25 / Month

No. of Combinations

> 270,000

> 720,000

No. of Properties

> 60

> 130

No. of Values

With > 2,500

With > 190,000

No. of Data Centres

5 Global Data Centres

No. of Websites

Unlimited

Detections Per Minute

100

1,000

Support

Forum Support

TRIAL BUY

What's Covered

This tutorial illustrates how to append a CSV file containing User-Agent strings with IsMobile, PlatformName and PlatformVersion properties. The following aspects of the API are covered:

How to perform a User-Agent match.
How to reuse resources to perform subsequent matching.
How to retrieve match results for a specific property.
How to append a property value to a CSV file.

Code and Explanation

Offline processing example of using 51Degrees device detection. The example shows how to:

Import settings from the 51Degrees settings file

dataFile = settings.V3_WRAPPER_DATABASE
properties = settings.PROPERTIES
cacheSize = settings.CACHE_SIZE
poolSize = settings.POOL_SIZE

Instantiate the 51Degrees device detection provider with these properties

provider = fiftyone_degrees_mobile_detector_v3_wrapper.Provider(dataFile,
	properties,
	cacheSize,
	poolSize)

Open an input file with a list of User-Agents, and an output file,
```
fin = open(inputFile, 'r')
fout = open(outputFile, 'w')
```
Write a header to the output file with the property names in '|' separated CSV format ('|' separated because some User-Agents contain commas)
```
fout.write('User-Agent')
for name in properties.split(','):
	fout.write('|' + name)
fout.write('\n')
```

For the first 20 User-Agents in the input file, perform a match then write the User-Agent along with the values for chosen properties to the CSV.

while i < 20 :
	userAgent = fin.readline().rstrip('\n')
	fout.write(userAgent)
	device = provider.getMatch(userAgent)
	for name in properties.split(','):
		value = device.getValue(name)
		fout.write('|' + value)
	fout.write('\n')
	i = i + 1

This example can be run in any directory, but assumes your settings file contains a valid dataFile location and has the IsMobile property selected.

Full Source File

from FiftyOneDegrees import fiftyone_degrees_mobile_detector_v3_wrapper
from fiftyone_degrees.mobile_detector.conf import settings
import sys

'''
Imports settings from the settings file. The Default settings file, and
details on how to change it can be output by running the command
<p><pre class="prettyprint lang-py">
51degrees-mobile-detector settings
</p></pre>
'''
dataFile = settings.V3_WRAPPER_DATABASE
properties = settings.PROPERTIES
cacheSize =  settings.CACHE_SIZE
poolSize = settings.POOL_SIZE

inputFile = '../../data/20000 User Agents.csv'
outputFile = 'offlineProcessingOutput.csv'

'''
Initialises the device detection provider with settings from the settings
file. By default this will use the included Lite data file For more info
see:
<a href="https://51degrees.com/compare-data-options">compare data options
</a>
'''
provider = fiftyone_degrees_mobile_detector_v3_wrapper.Provider(
    dataFile,
    properties,
    cacheSize,
    poolSize)

# Carries out match for first 20 User-Agents and prints results to
# output file.
def output_offline_processing():
    fin = open(inputFile, 'r')
    fout = open(outputFile, 'w')
    fout.write('User-Agent')
    for name in properties.split(','):
        fout.write('|' + name)

    fout.write('\n')
    i = 0
    while i < 20 :
        userAgent = fin.readline().rstrip('\n')
        fout.write(userAgent)
        match = provider.getMatch(userAgent)
        for name in properties.split(','):
            value = match.getValue(name)
            fout.write('|' + value)
        fout.write('\n')
        i += 1
    fin.close()
    fout.close()

def main():
    sys.stdout.write('Starting Offline Processing\n')
    output_offline_processing()
    sys.stdout.write('Output Written to %s\n' % outputFile)
if __name__ == '__main__':
    main()

Full Source File

Summary

Offline device detection is frequently required for a variety of reasons such as generating reports. The example is based on an actual support request where several properties had to be added to the CSV file before it could be passed on for another department to use.

This tutorial covered how to use the detector offline to append the first 20 lines of a CSV file with Lite properties: IsMobile, PlatformName and PlatformVersion. Using a Premium or an Enterprise data file gives you access to a far greater number of properties including HardwareVendor, PriceBand, ScreenInchesWidth, IsCrawler and more. A full list of properties and the data file version they are present in can be viewed in the Property Dictionary.

Compare Data Options

Device Detection

Enhanced Analytics

Image Optimiser

Performance Monitoring

On-Premise

Cloud

Legal T&Cs

Adtech

Brands

Publishers

CMS

Read Case Studies

Compatible Web Platforms

Developer Documentation

Enhanced Data

APIs

Property Dictionary

User Agent Tester

Developer Blogs

Forum

Store

FAQs

Device Explorer

Competitor Comparison

Images

Mobile Emulators

Python API

What's Covered

Code and Explanation

Summary

More Tutorials

	51Degrees	DeviceAtlas	ScientiaMobile WURFL^TM
>910,000 Device Combinations
0.0009ms Average Detection Time
> 99.9% Accuracy
Slow Regular Expressions
Confidence Indicators (false positives)
Granted Patents EU and US