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!

Automated computational research notebook.

Project Description

Automatic Computational Research Notebook

acorn uses the mutability of python objects, together with decorators, to produce an automatic notebook for computational research. Common libraries like numpy, scipy, sklearn and pandas are mutated with decorators that enable logging of calls to important methods within those libraries.

This is really helpful for data science where experimenting with fits, pipelines and pre-processing transformations can result in hundreds of fits and predictions a day. At the end of the day, it is hard to remember which set of parameters produced that one fit, which (of course) you didn’t realize was important at the time.

The library is well documented.

Basic Flow

  1. Depending on the logging level, every time a method/function is called (whether bound or unbound), we log it into a JSON database.
  2. The JSON database is analyzed using javascript by the browser to produce nice sets of objects, separated by project, task, date and specific object instances.
  3. A nice UI using bootstrap populates the HTML dynamically.

Synchronization

We recommend that the JSON database directory be configured on a Dropbox folder (later we will support Google Drive, etc.). The HTML notebook can be authorized (per session) to have access to Dropbox so that the JSON databases can be accessed from anywhere (and any device). Thi HTML and javascript is completely standalone (i.e., no server backend required outside of the web service requests).

Contribution

If this sparks your interest, please message us. The project is still in early development, so we can’t say more up front.

Special Notes

The matplotlib module is used frequently, but not in the typical way. Most of the methods and objects are used internally unless a plot is being tweaked for some special reason. The matplotlib.cfg file prunes the number of objects that get decorate very aggressively so that only the common calls are logged. You can adjust your own local config file if you spend a lot of time actually coding matplotlib internals.

Release History

Release History

This version
History Node

0.0.15

History Node

0.0.14

History Node

0.0.13

History Node

0.0.12

History Node

0.0.10

History Node

0.0.9

History Node

0.0.8

History Node

0.0.7

History Node

0.0.6

History Node

0.0.5

History Node

0.0.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
acorn-0.0.15-py2-none-any.whl (61.3 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Apr 3, 2017
acorn-0.0.15.tar.gz (45.1 kB) Copy SHA256 Checksum SHA256 Source Apr 3, 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