cuticula

Cuticula tries to provide a smart and customizable pipeline for preprocessing data for machine learning tasks. Clean preprocessing methods for the most common type of data, makes preprocessing easy. Cuticula offers a pipeline of Modifiers and Transformers to turn non-numeric data into a safe and consistent numeric output - known as Blobs. For putting your preprocessed data to use, you might like to use the Machine Learning Framework Leaf.

For more information see the Documentation.

Contributing

Want to contribute? Awesome! We have instructions to help you get started contributing code or documentation.

Autumn has a mostly real-time collaboration culture and happens on the Autumn Gitter Channels. Or you reach out to the Maintainers. e.g. {@MJ, @hobofan}.

Architecture

Cuticula exposes several standard data types, which might need a numeric transformation in order to be processed by a Machine Learning Algorithm such as Neural Nets.

Data Types can be modified through Modifiers. This provides a coherent interface, allowing for custom modifiers. You can read more about custom modifiers further down. First, an example of a Data Type modification:

let mut data_type = Image { value: ... }
data_type = data_type.set((ModifierOne(param1, param2), ModifierTwo(anotherParam));
image.set(Resize(20, 20))

After one, none or many modifications through Modifiers, the Data Type can then finally be transformed into a Blob (numeric Vector). Taking data_type from the above example:

// the Vector secures the correct shape and capacity of the final Blob
let final_blob = data_type.transform(vec![20, 20, 3]).unwrap();

Transformable Data Types

These are the data types that cuticula is currently addressing. For most of them are basic Modifiers and Transformers already specified.

• Missing: NULL data
• Label: labeled data such as ID's, Categories, etc.
• Word: a String of arbitrary lengths
• Image
• Audio

Modifiers

All Modifiers implement the Modifier trait from rust-modifier. As all Transformable Data Types implement the Set trait of the same library, one can easily write custom modifiers as well. Quick Example:

extern crate cuticula;

use cuticula::Image;
use cuticula::modifier::Modifier;

struct CustomModifier(usize)

impl Modifier<Image> for CustomModifier {
    fn modify(self, image: &mut Image) {
        image.value = some_extern_image_manipulation_fn(self.0);
    }
}