Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A scientific research assistant

Project Description

Acton is a modular Python library for active learning. Acton is a suburb in Canberra, where Australian National University is located.

Dependencies

Most dependencies will be installed by pip. You will need to manually install:

Setup

Install Acton using pip3:

pip install git+https://github.com/chengsoonong/acton.git

This provides access to a command-line tool acton as well as the acton Python library.

Acton CLI

The command-line interface to Acton is available through the acton command. This takes a dataset of features and labels and simulates an active learning experiment on that dataset.

Input

Acton supports three formats of dataset: ASCII, pandas, and HDF5. ASCII tables can be any file read by astropy.io.ascii.read, including many common plain-text table formats like CSV. pandas tables are supported if dumped to a file from DataFrame.to_hdf. HDF5 tables are either an HDF5 file with datasets for each feature and a dataset for labels, or an HDF5 file with one multidimensional dataset for features and one dataset for labels.

Output

Acton outputs a file containing predictions for each epoch of the simulation. These are encoded as specified in this notebook.

Quickstart

You will need a dataset. Acton currently supports ASCII tables (anything that can be read by astropy.io.ascii.read), HDF5 tables, and Pandas tables saved as HDF5. Here’s a simple classification dataset that you can use.

To run Acton to generate a passive learning curve with logistic regression:

acton --data classification.txt --label col20 --feature col10 --feature col11 -o passive.pb --recommender RandomRecommender --predictor LogisticRegression

This command uses columns col10 and col11 as features, and col20 as labels, a logistic regression predictor, and random recommendations. It outputs all predictions for test data points selected randomly from the input data to passive.pb, which can then be used to construct a plot. To output an active learning curve using uncertainty sampling, change RandomRecommender to UncertaintyRecommender.

To show the learning curve, use acton.plot:

python3 -m acton.plot passive.pb

Look at the directory examples for more examples.

Release History

Release History

This version
History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
acton-0.3.3.tar.gz (21.1 kB) Copy SHA256 Checksum SHA256 Source Feb 15, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting