libsr

libsr is a sketch recognition library. What is sketch recognition? Well, it's a field of research that attempts to recognize a list of timestamped coordinates as some number of geometric shapes.

Building & Installing

libsr is still in its infancy! Please contribute by downloading, compiling, and installing it, then the stroke collector and sending me the resultant files.

Building libsr requires the following libraries (tested on some versions of Ubuntu only).

• autoreconf
• libtool
• libopenblas-dev
• liblapacke-dev

If you'd like its tests to work, you'll also need:

• check

And for bindings into other languages (currently only Python):

• swig
• Python Qt5 bindings.

Do build its docs, you'll also need:

• doxygen
• graphviz
• pdflatex

To build libsr in a separate build/ directory, start from the location you checked out libsr and run:

$ mkdir build
$ cd build
$ autoreconf -i .. && ../configure && make
$ sudo make install

If all goes well, /usr/local/lib/libsr.so (and if you've installed swig and Python's Qt5 bindings, /usr/local/lib/python2.7/libsr/) will be created.

Contributing

Currently, I'm most in need of stroke data to test against! To create some stroke data, download, build, and install libsr as described above; make sure to follow the instructions concerning Python Qt5:

1. Run tools/collector.py
2. Draw some strokes.
3. Save the strokes to a file (with a descriptive name, please) using the File --> Save dialog.
4. Create a GitHub issue with the stroke data tag. Attach your stroke files to the issue.

I'll download it and incorporate the data.

Thank you!

Roadmap

Here's a rough roadmap. This section should help you know what to expect going forward, and outlines the final vision for libsr.

Core Libraries

The core libraries are the goal of the project. They include several sketch recognizers, and some geometry and general utilities.

common/ (library): Generally useful library consisting of some geometry utilities.

PaleoSketch: PaleoSketch, by Brandon Paulson. I'll also include a derivative of mine, NeaSketch.

DollarP (or "$P"?): A simple template-based recognizer.

Ouyang: That symbol recognizer by Tom Ouyang.

Tools

Stroke Collector: To collect test data from different people. Could be used for creating academic test suites.

Real-time Testing Suite: This will also serves as bare bones example.

(other language bindings?)

Demos

Free Body Diagram Simulator: Like that one MIT project: ASSIST, but completely Free.

Timeline

See TASKS.md.