Skip to main content

Atalaya is a logger for pytorch.

Project description


This framework provides a logger for pytorch models, it allows you to save the parameters, the state of the network, the state of the optimizer and allows also to save and visualize your data using tensorboardX or visdom.


$ pip install atalaya


An example is provided here.

Launch the example doing :

$ ./

An example of logs produced by the logger are given in the logs folder of the example.



from atalaya import Logger

logger = Logger(
    name="exp",         # name of the logger
    path="logs",        # path to logs
    verbose=True,       # logger in verbose mode

# by default Logger uses no grapher
# you can setup it by specifying if you want visdom or tensorboardX
logger = Logger(
    name="exp",         # name of the logger
    path="logs",        # path to logs
    verbose=True,       # logger in verbose mode
    username="user",    # if needed for visdom
    password="pwd",     # if needed for visdom

# your code here

# to close the logger

Log Information

# logs information in console and in log file."your", "information", "here", "like", "a", "print")

# same as but for warning messages
logger.warning("your warning")

Store your Parameters

# save your parameters into a json file

# load the parameters froma previous experiment

Store and Restore (models and optimizers)

  1. Add the model (or optimizer or whatever that has a state_dict in pytorch)

    Before starting storing or restoring objects you need to add them to the logger:

        logger.add("model", model)
        logger.add("optimizer", optimizer)
  2. Store the model

    In training loop we can add this method, it allows us to save checkpoints, and the best model.

    • The parameter valid_loss is simply the parameter to know when to save the best. It looks if the new valid_loss is less than the value keep by the logger as lower if it's the case save as best and update the value keep in memory.
    • The parameter save_every specify how often to save a checkpoint during training.
    • overwrite specify if we want to overwrite the last checkpoint to keep only the last one or if we want to keep them all (saves a model per epoch --> DANGEROUS), save_every=1, overwrite=True)
  3. Restore the model To restore the best after taining simply do


    To restore a checkpoint from another exp :


    To restore the best from another exp :

        logger.restore(folder=path_to_folder, best=True)


Some examples of grapher methods.

logger.add_scalar("train_mse", scalar_value, global_step=None, save_csv=True)

logger.add_text("tag", "your text here")

# values for each batch size at a given epoch
values = {
    "mse": [10, 9, 8, 7],
    "acc": [0.3, 0.5, 0.55, 0.6]
logger.register_plots(values, epoch, "train", apply_mean=True, save_csv=True, info=True)

Project details

Download files

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

Files for atalaya, version
Filename, size File type Python version Upload date Hashes
Filename, size atalaya- (13.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size atalaya- (23.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page