surveydata 0.1.2

Flexible access to survey data

The surveydata Python package offers flexible access to survey data.

Overview

To use the surveydata package, you access data from specific survey platforms via an appropriate SurveyPlatform object:

• SurveyCTOPlatform provides support for SurveyCTO data, including text audits

All survey data must be stored somewhere, and storage is handled via an appropriate StorageSystem object:

• FileStorage provides support for local file storage

• S3Storage provides support for AWS S3 storage

• DynamoDBStorage provides support AWS DynamoDB storage

• SurveyCTOExportStorage provides support for local exports from SurveyCTO Desktop

In general, the workflow goes like this:

1. Initialize the survey platform

2. Initialize one or more storage systems

3. Synchronize data between the survey platform and the storage system(s) to ensure that data in storage is fully up-to-date

4. Load data and/or attachments via the survey platform and storage API’s

(When using a static data export for storage, via a class like SurveyCTOExportStorage, the synchronize step is skipped, but otherwise everything is the same.)

Examples

See this example notebook for a series of usage examples.