ITEM Quantity to CUSTOMER item Quantity ratio 14d

SDK code to create ITEM_Quantity_to_CUSTOMER_item_Quantity_ratio_14d¶

Feature description:

Ratio of item Quantity to the total sum of item Quantity among all items with the same customer as that item over the 14d period.

In [ ]:

import featurebyte as fb
fb.use_profile("tutorial")

import featurebyte as fb fb.use_profile("tutorial")

Activate catalog¶

See SDK reference for catalogs

In [ ]:

catalog = fb.Catalog.activate("Grocery Dataset Tutorial")

catalog = fb.Catalog.activate("Grocery Dataset Tutorial")

Set windows for aggregation¶

In [ ]:

windows = ['14d']

windows = ['14d']

Get view from table¶

See SDK reference for views

In [ ]:

# Get view from INVOICEITEMS item table.
invoiceitems_view = catalog.get_view("INVOICEITEMS")

# Get view from INVOICEITEMS item table. invoiceitems_view = catalog.get_view("INVOICEITEMS")

Create Lookup feature¶

See SDK reference for features

See SDK reference to declare a lookup feature

In [ ]:

# Create lookup feature from Quantity column for item entity.
item_quantity =\
invoiceitems_view["Quantity"].as_feature("ITEM_Quantity")

# Create lookup feature from Quantity column for item entity. item_quantity =\ invoiceitems_view["Quantity"].as_feature("ITEM_Quantity")

Do window aggregation from INVOICEITEMS¶

See SDK reference for features

See SDK reference to groupby a view

See SDK reference to do aggregation over time

See SDK reference for feature group

See list of aggregation operations

In [ ]:

# Group INVOICEITEMS view by customer entity (GroceryCustomerGuid).
invoiceitems_view_by_customer =\
invoiceitems_view.groupby(['GroceryCustomerGuid'])

# Group INVOICEITEMS view by customer entity (GroceryCustomerGuid). invoiceitems_view_by_customer =\ invoiceitems_view.groupby(['GroceryCustomerGuid'])

In [ ]:

# Get Sum of Quantity for the customer over time.
feature_group =\
invoiceitems_view_by_customer.aggregate_over(
    "Quantity", method="sum",
    feature_names=[
        "CUSTOMER_Sum_of_item_Quantity"
        + "_" + w for w in windows
    ],
    fill_value=0,
    windows=windows
)
# Get CUSTOMER_Sum_of_item_Quantity_14d object from feature group.
customer_sum_of_item_quantity_14d =\
feature_group["CUSTOMER_Sum_of_item_Quantity_14d"]

# Get Sum of Quantity for the customer over time. feature_group =\ invoiceitems_view_by_customer.aggregate_over( "Quantity", method="sum", feature_names=[ "CUSTOMER_Sum_of_item_Quantity" + "_" + w for w in windows ], fill_value=0, windows=windows ) # Get CUSTOMER_Sum_of_item_Quantity_14d object from feature group. customer_sum_of_item_quantity_14d =\ feature_group["CUSTOMER_Sum_of_item_Quantity_14d"]

Compare lookup with aggregation¶

See list of feature transforms

In [ ]:

# Get the Ratio of item Quantity to the total sum of item Quantity among all items with the same
# customer as that item over the 14d period.
item_quantity_to_customer_item_quantity_ratio_14d = (
    item_quantity
    / customer_sum_of_item_quantity_14d
)
# Give a name to new feature
item_quantity_to_customer_item_quantity_ratio_14d.name = \
"ITEM_Quantity_to_CUSTOMER_item_Quantity_ratio_14d"

# Get the Ratio of item Quantity to the total sum of item Quantity among all items with the same # customer as that item over the 14d period. item_quantity_to_customer_item_quantity_ratio_14d = ( item_quantity / customer_sum_of_item_quantity_14d ) # Give a name to new feature item_quantity_to_customer_item_quantity_ratio_14d.name = \ "ITEM_Quantity_to_CUSTOMER_item_Quantity_ratio_14d"

Preview feature¶

Read on the feature primary entity concept

Read on the serving entity concept

See SDK reference for observation table

See SDK reference to preview feature

In [ ]:

#Check the primary entity of the feature'
item_quantity_to_customer_item_quantity_ratio_14d.primary_entity

#Check the primary entity of the feature' item_quantity_to_customer_item_quantity_ratio_14d.primary_entity

In [ ]:

#Get observation table: 'Preview Table with 10 items'
preview_table = catalog.get_observation_table(
	"Preview Table with 10 items"
)

#Get observation table: 'Preview Table with 10 items' preview_table = catalog.get_observation_table( "Preview Table with 10 items" )

In [ ]:

#Preview ITEM_Quantity_to_CUSTOMER_item_Quantity_ratio_14d
item_quantity_to_customer_item_quantity_ratio_14d.preview(
	preview_table
)

#Preview ITEM_Quantity_to_CUSTOMER_item_Quantity_ratio_14d item_quantity_to_customer_item_quantity_ratio_14d.preview( preview_table )

Save feature¶

See SDK reference to save feature

In [ ]:

# Save feature
item_quantity_to_customer_item_quantity_ratio_14d.save()

# Save feature item_quantity_to_customer_item_quantity_ratio_14d.save()

Add description and see feature definition file¶

See SDK reference for the definition file of a feature

In [ ]:

# Add description
item_quantity_to_customer_item_quantity_ratio_14d.update_description(
	"Ratio of item Quantity to the total sum of item Quantity among all "
	"items with the same customer as that item over the 14d period."
)
# See feature definition file
item_quantity_to_customer_item_quantity_ratio_14d.definition

# Add description item_quantity_to_customer_item_quantity_ratio_14d.update_description( "Ratio of item Quantity to the total sum of item Quantity among all " "items with the same customer as that item over the 14d period." ) # See feature definition file item_quantity_to_customer_item_quantity_ratio_14d.definition