pythogram-core/README.txt at master · cpsaltis/pythogram-core · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
pythogram-core
==============

:Version: 0.1
:Author: Christodoulos Psaltis (cpsaltis)
:Source: https://github.com/cpsaltis/pythogram-core
:License: MIT
:Keywords: python, photogrammetry, artificial data, feature extraction, machine learning, classification

Pythogram-core is a wrapper of several popular image processing and machine learning libraries. It provides a helpful command line tool to run complex workflows. It makes easy to integrate with other systems since it can communicate and execute tasks from JSON task files.

Before installing
-----------------
Pythogram-core requires python version > 2.6 and < 3.0. You'll need some basic libraries and tools depending on your OS.

In a Debian based distro you'll need to::

    sudo aptitude install build-essential python-dev gfortran libatlas-base-dev python-virtualenv python-pip git

In MacOSX you'll need to install:

* XCode and its command line tools,
* git
* pip and virtualenv
* a packaging manager like Homebrew or MacPorts

Pip and virtualenv can be easily installed from the command line with::

    sudo easy_install pip
    sudo pip install virtualenv

Assuming you're using Homebrew you'll need to::

    brew install jpeg libtiff gfortran

Installation
------------
Pythogram-core depends on:

* numpy and scipy for basic computations,
* pillow/PIL for image IO,
* scikit-image for feature extraction,
* and scikit-learn for machine learning

To setup all of the above in a virtualenv::

    virtualenv pythogram-core
    cd pythogram-core
    ./bin/pip install numpy
    ./bin/pip install scipy
    ./bin/pip install cython
    ./bin/pip install pillow scikit-image scikit-learn
    ./bin/pip install -e git+http://github.com/cpsaltis/pythogram-core.git#egg=pythogram-core

Note that the order of installation steps is important. Scipy 0.10.1 doesn't work with numpy 1.6.2, but 0.10.0 does, see README.txt in http://sourceforge.net/projects/scipy/files/scipy/0.10.1/. In scipy 0.11.0 this issue has been resolved.

Optionally iPython can be very helpful in prototyping::

    ./bin/pip install ipython

If you plan to contribute to Pythogram you'll also need::

    ./bin/pip install pep8 sphinx pylint nose coverage


Changelog
---------

`0.1 (2012-12-02) [cpsaltis]`

This is the initial version of pythogram-core. It supports:

* I/O of images and arrays,
* generation of artificial tiled and syntethic images,
* generation of artificial DTMs and DSMs,
* basic arithmetic operations on arrays,
* NDVI calculation,
* skimage rotate and resize
* command line script, called gram, parsing an input JSON to execute complex workflows