Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
AlvarBer committed May 6, 2017
1 parent 4845b1a commit 411394c
Show file tree
Hide file tree
Showing 7 changed files with 22 additions and 30 deletions.
50 changes: 21 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,27 @@
Project Definition ![travis](https://travis-ci.org/AlvarBer/Persimmon.svg?branch=master)
==================
Persimmon ![travis](https://travis-ci.org/AlvarBer/Persimmon.svg?branch=master)
===================

Problem
-------
Machine Learning is a multi-disciplinary subject. Because of this learners come from a variety of backgrounds,
and the mastering process can be though, specially when some of these backgrounds don't have strong programming foundations.
![Final aspect](docs/images/final_aspect.png)

<img src="https://2.bp.blogspot.com/-UNxoJDELWyw/V-E4f2V9BwI/AAAAAAAAMFs/GWd7v4tRUKMfaXqQODy403gCicrwET85ACLcB/s1600/Data_Science_VD.png" width=200>
What is it?
-----------
Persimmon is a visual dataflow language for creating sklearn pipelines.

Approaches
---------
A visual interface for programming could help easing the steep learning curve, focusing on the methods, the intuition and
their connections instead on the technicals details of the underlying library.
It represents functions as blocks, inputs and outputs are presented as pins,
and type safety is enforced when the connection is being made.

Possible Outcomes
-----------------
* Greater engagement than traditional coding
* Similar engagement than traditional coding
* Less engagement than traditional coding
![Type safety](docs/images/type_safety.gif)

Each of these outcomes can occur for the same project based on the user background.

Experimentation
How to install?
---------------
The ideal experimentation would include trials with subjects from the following backgrounds
* Statistics
* Mahematics
* Physics/Engineering
* CS
* Others (Business, etc...)

Trials would be based on
* A/B Testing based on different interfaces paradigms (Including no visual interface at all)
* Focus groups with iterative feedback that can influence development
If you have pip (Python 3.5+) you can simply type

`$> pip install persimmon`

For windows self-contained executables can be found on the [releases page].


![Full use](docs/images/full_use.gif)


[releases page]: https://github.com/AlvarBer/Persimmon/releases
Binary file added docs/images/final_aspect.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/full_use.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/images/fully_automatic_workflow.png
Binary file not shown.
Binary file added docs/images/type_safety.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/images/weka.jpeg
Binary file not shown.
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
author_email='alvaro.garcia95@hotmail.com',
version='0.8',
url='http://github.com/alvarber/Persimmon',
download_url='https://github.com/AlvarBer/Persimmon/archive/v0.7-beta.tar.gz',
download_url='https://github.com/AlvarBer/Persimmon/archive/v0.8-beta.tar.gz',
license='MIT',
packages=find_packages(),
include_package_data=True,
Expand Down

0 comments on commit 411394c

Please sign in to comment.