Skip to main content

A declarative Keras interface.

Project description

This package is in alpha stage. This README is a work in progress.

Creating Experiments

There are two types of experiments: training experiments, which involve training a new or existing model, and testing experiments, which involve testing an existing model.

keras.train --config_file path/to/config/file.yaml

keras.test --config_file path/to/config/file.yaml

Specifying Keras Objects

Keras Declarative automatically discovers objects, such as layers and loss functions, which are available in core TensorFlow, TensorFlow MRI and TF Playground. This means these objects can be used in the configuration file without explicit registration.

Serializable Keras objects, such as layers and loss functions, are specified by a class name and a configuration dictionary. If no parameters should be passed to the object, the configuration dictionary may be omitted.

# class name and parameters
    class_name: Adam
      learning_rate: 0.001

# class name only (instantiated with default parameters)
  optimizer: Adam

External Modules

It is possible to use objects defined in external modules within Keras Declarative, i.e., objects that are not part of either core TensorFlow, TensorFlow MRI or TF Playground. This is particularly useful to define preprocessing functions but can be used for any other purpose. External modules can be specified with the $external directive.

Any external modules used during an experiment will be automatically saved to the experiment folder to enable reproducibility.

      - type: map
              # Use a preprocessing function defined in an external module.
              filename: /path/to/
              object_name: preprocessing_fn
              # Any parameters that should be passed to this object may be
              # specified here.
              args: null
              kwargs: null

Anchors and Aliases

If you need to repeat a node more than once, you can anchor it once with the & character and then alias it any number of times using the * character. For example, to use the same list of data transforms for the training and validation sets, you may use:

    train: &transforms
      # Define the list of transforms here.

    val: *transforms  # Reusing training transforms here.

Hyperparameter Tuning

Keras Declarative can configure the Keras Tuner to automatically tune one or more parameters.

Most parameters can be set as tunable using the $tunable directive. For example, to tune the kernel size of a U-Net model, you might use:

    class_name: UNet
      scales: 3
      base_filters: 32
          type: int
            name: kernel_size
            min_value: 3
            max_value: 7
            step: 2

Valid tunable types are boolean, choice, fixed, float and int. For more details, see

The tuner type and options can be specified with tuning.tuner parameter:

    class_name: Hyperband
        name: val_ssim
        direction: max
      max_epochs: 100

Available tuners are RandomSearch, BayesianOptimization and Hyperband. For more details about these tuners and their options, see

Note that some parameters cannot be tuned. These include all parameters under experiment and under data.sources.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

keras_declarative-0.6.0-py3-none-any.whl (52.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page