Skip to content

Model Persistence#

Model persistence is the ability to save and subsequently load a learner's state in another process. Trained estimators can be used for real-time inference by loading the model onto a server or they can be saved to make predictions in batches offline at a later time. Estimators that implement the Persistable interface are able to have their internal state captured between processes. In addition, the library provides the Persistent Model meta-estimator that acts as a wrapper for persistable estimators.

Serialization#

Serialization occurs in between saving and loading a model and can be thought of as packaging the model's parameters. The data can be in a lightweight format such as with PHP's Native serializer or in a robust format such as RBX. In the this example, we'll demonstrate how to encode a Persistable learner using the compressed RBX format, save the encoding with a Persister, and then how to deserialize the encoding.

use Rubix\ML\Classifiers\RandomForest;
use Rubix\ML\Serializers\RBX;
use Rubix\ML\Persisters\Filesystem;

$estimator = new RandomForest(100);

$serializer = new RBX();

$encoding = $serializer->serialize($estimator);

$estimator = $serializer->deserialize($encoding);

Note

Due to a limitation in PHP, anonymous classes and functions (closures) are not able to be deserialized. Therefore, avoid anonymous classes or functions if you intend to persist the model.

Persistent Model Meta-estimator#

The persistence subsystem can be interfaced at a low level with Serializer and Persister objects or it can be interacted with at a higher level using the Persistent Model meta-estimator. It is a decorator that provides save() and load() methods giving the estimator the ability to save and load itself.

use Rubix\ML\PersistentModel;
use Rubix\ML\Clusterers\KMeans;
use Rubix\ML\Persisters\Filesystem;

$estimator = new PersistentModel(new KMeans(5), new Filesystem('example.rbx'));

$estimator->train($dataset);

$estimator->save();
use Rubix\ML\PersistentModel;
use Rubix\ML\Persisters\Filesystem;

$estimator = PersistentModel::load(new Filesystem('example.rbx'));

Persisting Transformers#

In addition to Learners, the persistence subsystem can be used to individually save and load any Stateful transformer that implements the Persistable interface. In the example below we'll fit a transformer to a dataset and then save it to the Filesystem.

use Rubix\ML\Transformers\OneHotEncoder;
use Rubix\ML\Serializers\RBX;
use Rubix\ML\Persisters\Filesystem;

$transformer = new OneHotEncoder();

$serializer = new RBX();

$transformer->fit($dataset);

$serializer->serialize($transformer)->saveTo(new Filesystem('example.rbx'));

Then, to load the transformer in another process call the deserialize() method on the encoding returned by the persister's load() method.

use Rubix\ML\Serializers\RBX;
use Rubix\ML\Persisters\Filesystem;

$transformer = $persister->load()->deserializeWith(new RBX());

Caveats#

Since model data are exported with the learner's current class definition in mind, problems may occur when loading a model using a different version of the library than the one it was trained and saved on. For example, when upgrading to a new version, there is a small chance that a previously saved learner may not be able to be deserialized if the model is not compatible with the learner's new class definition. For maximum interoperability, ensure that each system is running the same version of the library.