by QUVA-Lab

QUVA-Lab / artemis

Artemis aims to get rid of all the boring, bureaucratic coding (plotting, file management, organizin...

209 Stars 25 Forks Last release: over 2 years ago (2.1.1) Other 922 Commits 9 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


The deer represents dull, repetitive coding tasks, and Artemis represents Artemis.  As you can see, once Artemis comes along, the future is not bright for dull, repetitive coding tasks.

Artemis is a collection of tools that make it easier to run experiments in Python. These include:

A simple framework for organizing your experiments and logging their results (text output and figures) so that they can be reviewed later and replicated easily.

e.g. ``` from artemis.experiments import experiment_function

@experimentfunction # Decorate your main function to turn it into an Experiment object def multiply3_numbers(a=1, b=2, c=3): answer = abc print('{} x {} x {} = {}'.format(a, b, c, answer)) return answer

record = # Run experiment and save arguments, console output, and return value to disk print(record.getlog()) # Pring console output of last run
result()) # Print return value of last run ex = multiply3numbers.addvariant(a=4, b=5) # Make a new experiment with different paremters. multiply3_numbers.browse() # Open a UI to browse through all experiments and results. ```

A dbplot function, for making live "debug" plots of numeric data on the fly.


from artemis.plotting.db_plotting import dbplot
import numpy as np
for t in np.linspace(0, 10, 100):
    dbplot(np.sin(t), 'sin of the times')  # Detects data type and makes appropriate plot
    dbplot(np.sin(-4*t+np.sin(t/4.)*sum(xi**2 for xi in np.meshgrid(*[np.linspace(-20, 20, 200)]*2))), "Instaaaaall Arrrteeeemis")
(this can also be set up in the browser for remote live plotting)

Functions for easy download and loading of numerical data.


from artemis.plotting.db_plotting import dbplot
from artemis.fileman.smart_io import smart_load
img = smart_load('')  # Detects data type and loads into numpy array
dbplot(im, 'artemis', hang=True)

A system for downloading/caching files to a local directory, so the same code can work on different machines.

from artemis.fileman.file_getter import get_file
import os
local_path = get_file(url = '')  # Downloads first time, caches after 
print('Image "{}" has a size of {:.2g}kB'.format(local_path, os.path.getsize(local_path)/1000.))

For more examples of how to use artemis, read the Artemis Documentation


As of release 2.0.0 on November 13, 2017, Artemis now supports Python 3

To use artemis from within your project, use the following to install Artemis and its dependencies: (You probably want to do this in a virtualenv with the latest version of pip - run

virtualenv venv; source venv/bin/activate; pip install --upgrade pip;
to make one and enter it).

Option 1: Simple install:

pip install artemis-ml

Option 2: Install as source.

pip install -e git+ 

This will install it in

(virtual env or system python root)/src/artemis
. You can edit the code and submit pull requests to our git repo. To install with the optional remote plotting mode enabled, add the
option, as in:
pip install -e git+[remote_plotting]

(Note, this doesn't work if you have Anaconda installed, as it does not work with the

option). Use

pip install artemis-ml
in this case instead.

Verifying that it works

To verify that the plotting works, run:

python -m artemis.plotting.demo_dbplot
A bunch of plots should come up and start updating live.

Note: During installation, the settings file

is created in your home directory. In it you can specify the plotting backend to use, and other settings.

Now that you have Artemis installed, see this Tutorial on how to use Artemis to organize your experiments.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.