NOTICE

The upcoming release of Featuretools 1.0.0 contains several breaking changes. Users are encouraged to test this version prior to release:

pip install featuretools==1.0.0rc1

For details on migrating to the new version, refer to Transitioning to Featuretools Version 1.0. Please report any issues in the Featuretools GitHub repo or by messaging in Alteryx Open Source Slack.


featuretools.primitives.AvgTimeBetween

class featuretools.primitives.AvgTimeBetween(unit='seconds')[source]

Computes the average number of seconds between consecutive events.

Description:

Given a list of datetimes, return the average time (default in seconds) elapsed between consecutive events. If there are fewer than 2 non-null values, return NaN.

Parameters

unit (str) – Defines the unit of time. Defaults to seconds. Acceptable values: years, months, days, hours, minutes, seconds, milliseconds, nanoseconds

Examples

>>> from datetime import datetime
>>> avg_time_between = AvgTimeBetween()
>>> times = [datetime(2010, 1, 1, 11, 45, 0),
...          datetime(2010, 1, 1, 11, 55, 15),
...          datetime(2010, 1, 1, 11, 57, 30)]
>>> avg_time_between(times)
375.0
>>> avg_time_between = AvgTimeBetween(unit="minutes")
>>> avg_time_between(times)
6.25
__init__(unit='seconds')[source]

Initialize self. See help(type(self)) for accurate signature.

Methods

__init__([unit])

Initialize self.

generate_name(base_feature_names, …)

generate_names(base_feature_names, …)

get_args_string()

get_arguments()

get_description(input_column_descriptions[, …])

get_filepath(filename)

get_function([agg_type])

Attributes

base_of

base_of_exclude

commutative

compatibility

default_value

description_template

input_types

max_stack_depth

name

number_output_features

stack_on

stack_on_exclude

stack_on_self

uses_calc_time