A framework for quickly creating machine learning models using Estimator API of TensorFlow.
Installation
pip install tensorflow
and run:
pip install estimator
It is recommended to use a virtual environment.
Getting Started
from estimator import Model
import tensorflow as tf
# Define the network architecture - layers, number of units, activations etc.
def network(inputs):
hidden = tf.layers.Dense(units=64, activation=tf.nn.relu)(inputs)
outputs = tf.layers.Dense(units=10)(hidden)
return outputs
# Configure the learning process - loss, optimizer, evaluation metrics etc.
model = Model(network,
loss='sparse_softmax_cross_entropy',
optimizer=('GradientDescent', 0.001),
metrics=['accuracy'])
# Train the model using training data
model.train(x_train, y_train, epochs=30, batch_size=128)
# Evaluate the model performance on test or validation data
loss_and_metrics = model.evaluate(x_test, y_test)
# Use the model to make predictions for new data
predictions = model.predict(x)
# or call the model directly
predictions = model(x)
More configuration options are available:
model = Model(network,
loss='sparse_softmax_cross_entropy',
optimizer=optimizer('GradientDescent', 0.001),
metrics=['accuracy'],
model_dir='/tmp/my_model')
You can also use custom functions for loss and metrics:
def custom_loss(labels, outputs):
pass
def custom_metric(labels, outputs):
pass
model = Model(network,
loss=custom_loss,
optimizer=('GradientDescent', 0.001),
metrics=['accuracy', custom_metric])
Example: CNN MNIST Classifier
This example is based on the MNIST example of TensorFlow:
from estimator import Model, GradientDescent, TRAIN
import tensorflow as tf
def network(x, mode):
x = tf.reshape(x, [-1, 28, 28, 1])
x = tf.layers.Conv2D(filters=32, kernel_size=[5, 5], padding='same', activation=tf.nn.relu)(x)
x = tf.layers.MaxPooling2D(pool_size=[2, 2], strides=2)(x)
x = tf.layers.Conv2D(filters=64, kernel_size=[5, 5], padding='same', activation=tf.nn.relu)(x)
x = tf.layers.MaxPooling2D(pool_size=[2, 2], strides=2)(x)
x = tf.layers.Flatten()(x)
x = tf.layers.Dense(units=1024, activation=tf.nn.relu)(x)
x = tf.layers.Dropout(rate=0.4)(x, training=mode == TRAIN)
x = tf.layers.Dense(units=10)(x)
return x
# Configure the learning process
model = Model(network,
loss='sparse_softmax_cross_entropy',
optimizer=('GradientDescent', 0.001))
mode parameter specifies whether the model is used for training, evaluation or prediction.
Model Function
To have more control, you may configure the model inside a function using Estimator class:
from estimator import Estimator, PREDICT
import tensorflow as tf
def model(features, labels, mode):
# Define the network architecture
hidden = tf.layers.Dense(units=64, activation=tf.nn.relu)(features)
outputs = tf.layers.Dense(units=10)(hidden)
predictions = tf.argmax(outputs, axis=1)
# In prediction mode, simply return predictions without configuring learning process
if mode == PREDICT:
return predictions
# Configure the learning process for training and evaluation modes
loss = tf.losses.sparse_softmax_cross_entropy(labels, outputs)
optimizer = tf.train.GradientDescentOptimizer(0.001)
accuracy = tf.metrics.accuracy(labels, predictions)
return dict(loss=loss,
optimizer=optimizer,
metrics={'accuracy': accuracy})
# Create the model using model function
model = Estimator(model)
# Train the model
model.train(x_train, y_train, epochs=30, batch_size=128)
License
Metadata
Release files for estimator 0.0.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| estimator-0.0.10.tar.gz | 6.1 kB | Without provenance | Details for estimator-0.0.10.tar.gz |
Release files / estimator-0.0.10.tar.gz
| Download URL | estimator-0.0.10.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aefd7d76940d283deefee1497f15487cd0521463e33f2f4c05507883af834bd6
|
|
BLAKE2b-256 checksum How to use checksums |
c3d262b223dc958401a6a7245c09dfe3975118f12798c1238ab9542ccb2e0e13
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for estimator 0.0.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.