neptunecontrib.api.table

Module Contents

Functions

log_table(name, table, experiment=None)

Logs pandas dataframe to neptune.

log_csv(name, table, experiment=None)

Logs pandas dataframe to neptune as csv file.

neptunecontrib.api.table.log_table(name, table, experiment=None)[source]

Logs pandas dataframe to neptune.

Pandas dataframe is converted to an HTML table and logged to Neptune as an artifact with path tables/{name}.html

Parameters
  • name (str) –

    Name of the chart (without extension) that will be used as a part of artifact’s destination.

  • table (pandas.Dataframe) –

    DataFrame table

  • experiment (neptune.experiments.Experiment, optional, default is None) –

    For advanced users only. Pass Neptune Experiment object if you want to control to which experiment data is logged.
    If None, log to currently active, and most recent experiment.

Examples

Start an experiment:

import neptune

neptune.init(api_token='ANONYMOUS',
             project_qualified_name='shared/showroom')
neptune.create_experiment(name='experiment_with_tables')

Create or load dataframe:

import pandas as pd

iris_df = pd.read_csv('https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv', nrows=100)

Log it to Neptune:

from neptunecontrib.api import log_table

log_table('pandas_df', iris_df)

Check out how the logged table looks in Neptune: https://ui.neptune.ai/o/shared/org/showroom/e/SHOW-977/artifacts?path=tables%2F&file=pandas_df.html

neptunecontrib.api.table.log_csv(name, table, experiment=None)[source]

Logs pandas dataframe to neptune as csv file.

Pandas dataframe is converted to csv fie and logged to Neptune as an artifact with path csv/{name}.csv

Parameters
  • name (str) –

    Name of the file (without extension) that will be used as a part of csv’s destination.

  • table (pandas.Dataframe) –

    DataFrame table

  • experiment (neptune.experiments.Experiment, optional, default is None) –

    Neptune Experiment object if you want to control to which experiment you log the data.
    If None, log to currently active, and most recent experiment.

Examples

Create or load dataframe:

import pandas as pd
iris_df = pd.read_csv('https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv', nrows=100)

Log it to Neptune:

from neptunecontrib.api import log_csv
log_csv('pandas_df', iris_df)