TF-IDF Template

TF-IDF is a composite weight for each word in each document.

This page introduces a workflow template to calculate TF-IDF and to get top-k important keywords in each document. You can easily build a TF-IDF workflow following this guide.

Table of Contents


This workflow takes a table of the following form:



1 Justice, in its broadest context,…
2 Wisdom (sophia) is the ability to think …


We prepared a basic workflow for TF-IDF calculation and getting top-k important keywords in each document.

$ ./ # prepare sample dataset
$ ./ # prepare stopwords table
$ td wf push tfidf # push workflow to TD
$ td wf start tfidf tfidf --session now -p apikey=${YOUR_TD_API_KEY}
  • tfidf.dig – TD workflow script for TF-IDF calculation and getting top-k important keywords in each document.
  • config/params.yml – defines configurable parameters for the TF-IDF workflow such as k of top-k (default: 3), language of the documents (english/japanese, default: english).

Caution: This workflow presupposes the existence of stopwords table. You need to execute to create stopwords table, or if you use your own stopwords table, you should rewrite the table name in config/params.yml.

Note: stopwords are words such as the,is,at,which. These are filtered out before or after processing of natural language data.


The outputs of workflow are two tables.

One is collected table that a list of words and TF-IDF for each document as shown below:



1 [“justice:0.1758477689430746”,“based:0.07033910867777095”,…]
2 [“action:0.08688948589543341”,“wisdom:0.06516711579725143”,…]

Another table top_k contains a list of top-k keywords for each document as shown below:



1 [“philosophy”,“study”]
2 [“experience”,“knowledge”,“understanding”]

Note: Because of sample dataset has only 3 documents and the query to get top-k keywords in this workflow use words at least two occurrence in documents, the first row of the output table has only 2 words.

How This Workflow Works

For further reading for algorithm and/or workflow details, please refer this page.


Treasure Workflow and TF-IDF weighting technique enable you to analyze a collection of massive documents on cloud. Once you find TF-IDF scores and top-k words for each document, you can use the results in a wide variety of applications such as document clustering and recommendation.

Contact us if you interested in our paid consulting service.

Last modified: Apr 28 2017 09:59:28 UTC

If this article is incorrect or outdated, or omits critical information, please let us know. For all other issues, please see our support channels.