You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hivemall.apache.org by my...@apache.org on 2017/04/24 11:15:42 UTC
[17/23] incubator-hivemall-site git commit: Added userguide contents
about clustering and GeoSpatial
http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/blob/06c5398a/userguide/clustering/lda.html
----------------------------------------------------------------------
diff --git a/userguide/clustering/lda.html b/userguide/clustering/lda.html
new file mode 100644
index 0000000..de3831d
--- /dev/null
+++ b/userguide/clustering/lda.html
@@ -0,0 +1,2373 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+ <head>
+ <meta charset="UTF-8">
+ <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+ <title>Latent Dirichlet Allocation � Hivemall User Manual</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+ <meta name="description" content="">
+ <meta name="generator" content="GitBook 3.2.2">
+
+
+
+
+ <link rel="stylesheet" href="../gitbook/style.css">
+
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-splitter/splitter.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-etoc/plugin.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-callouts/plugin.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-toggle-chapters/toggle.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-codeblock-filename/block.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-expandable-chapters/expandable-chapters.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-multipart/multipart.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-katex/katex.min.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-emphasize/plugin.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
+
+
+
+ <link rel="stylesheet" href="../gitbook/gitbook-plugin-theme-api/theme-api.css">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <meta name="HandheldFriendly" content="true"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black">
+ <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
+ <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
+
+
+ <link rel="next" href="../geospatial/latlon.html" />
+
+
+ <link rel="prev" href="../anomaly/changefinder.html" />
+
+
+ </head>
+ <body>
+
+<div class="book">
+ <div class="book-summary">
+
+
+<div id="book-search-input" role="search">
+ <input type="text" placeholder="Type to search" />
+</div>
+
+
+ <nav role="navigation">
+
+
+
+<ul class="summary">
+
+
+
+
+ <li>
+ <a href="http://hivemall.incubator.apache.org/" target="_blank" class="custom-link"><i class="fa fa-home"></i> Home</a>
+ </li>
+
+
+
+
+ <li class="divider"></li>
+
+
+
+
+ <li class="header">TABLE OF CONTENTS</li>
+
+
+
+ <li class="chapter " data-level="1.1" data-path="../">
+
+ <a href="../">
+
+
+ <b>1.1.</b>
+
+ Introduction
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.2" data-path="../getting_started/">
+
+ <a href="../getting_started/">
+
+
+ <b>1.2.</b>
+
+ Getting Started
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="1.2.1" data-path="../getting_started/installation.html">
+
+ <a href="../getting_started/installation.html">
+
+
+ <b>1.2.1.</b>
+
+ Installation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.2.2" data-path="../getting_started/permanent-functions.html">
+
+ <a href="../getting_started/permanent-functions.html">
+
+
+ <b>1.2.2.</b>
+
+ Install as permanent functions
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.2.3" data-path="../getting_started/input-format.html">
+
+ <a href="../getting_started/input-format.html">
+
+
+ <b>1.2.3.</b>
+
+ Input Format
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="1.3" data-path="../tips/">
+
+ <a href="../tips/">
+
+
+ <b>1.3.</b>
+
+ Tips for Effective Hivemall
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="1.3.1" data-path="../tips/addbias.html">
+
+ <a href="../tips/addbias.html">
+
+
+ <b>1.3.1.</b>
+
+ Explicit addBias() for better prediction
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3.2" data-path="../tips/rand_amplify.html">
+
+ <a href="../tips/rand_amplify.html">
+
+
+ <b>1.3.2.</b>
+
+ Use rand_amplify() to better prediction results
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3.3" data-path="../tips/rt_prediction.html">
+
+ <a href="../tips/rt_prediction.html">
+
+
+ <b>1.3.3.</b>
+
+ Real-time Prediction on RDBMS
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3.4" data-path="../tips/ensemble_learning.html">
+
+ <a href="../tips/ensemble_learning.html">
+
+
+ <b>1.3.4.</b>
+
+ Ensemble learning for stable prediction
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3.5" data-path="../tips/mixserver.html">
+
+ <a href="../tips/mixserver.html">
+
+
+ <b>1.3.5.</b>
+
+ Mixing models for a better prediction convergence (MIX server)
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.3.6" data-path="../tips/emr.html">
+
+ <a href="../tips/emr.html">
+
+
+ <b>1.3.6.</b>
+
+ Run Hivemall on Amazon Elastic MapReduce
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="1.4" data-path="../tips/general_tips.html">
+
+ <a href="../tips/general_tips.html">
+
+
+ <b>1.4.</b>
+
+ General Hive/Hadoop tips
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="1.4.1" data-path="../tips/rowid.html">
+
+ <a href="../tips/rowid.html">
+
+
+ <b>1.4.1.</b>
+
+ Adding rowid for each row
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.4.2" data-path="../tips/hadoop_tuning.html">
+
+ <a href="../tips/hadoop_tuning.html">
+
+
+ <b>1.4.2.</b>
+
+ Hadoop tuning for Hivemall
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="1.5" data-path="../troubleshooting/">
+
+ <a href="../troubleshooting/">
+
+
+ <b>1.5.</b>
+
+ Troubleshooting
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="1.5.1" data-path="../troubleshooting/oom.html">
+
+ <a href="../troubleshooting/oom.html">
+
+
+ <b>1.5.1.</b>
+
+ OutOfMemoryError in training
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5.2" data-path="../troubleshooting/mapjoin_task_error.html">
+
+ <a href="../troubleshooting/mapjoin_task_error.html">
+
+
+ <b>1.5.2.</b>
+
+ SemanticException Generate Map Join Task Error: Cannot serialize object
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5.3" data-path="../troubleshooting/asterisk.html">
+
+ <a href="../troubleshooting/asterisk.html">
+
+
+ <b>1.5.3.</b>
+
+ Asterisk argument for UDTF does not work
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5.4" data-path="../troubleshooting/num_mappers.html">
+
+ <a href="../troubleshooting/num_mappers.html">
+
+
+ <b>1.5.4.</b>
+
+ The number of mappers is less than input splits in Hadoop 2.x
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="1.5.5" data-path="../troubleshooting/mapjoin_classcastex.html">
+
+ <a href="../troubleshooting/mapjoin_classcastex.html">
+
+
+ <b>1.5.5.</b>
+
+ Map-side Join causes ClassCastException on Tez
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part II - Generic Features</li>
+
+
+
+ <li class="chapter " data-level="2.1" data-path="../misc/generic_funcs.html">
+
+ <a href="../misc/generic_funcs.html">
+
+
+ <b>2.1.</b>
+
+ List of generic Hivemall functions
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="2.2" data-path="../misc/topk.html">
+
+ <a href="../misc/topk.html">
+
+
+ <b>2.2.</b>
+
+ Efficient Top-K query processing
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="2.3" data-path="../misc/tokenizer.html">
+
+ <a href="../misc/tokenizer.html">
+
+
+ <b>2.3.</b>
+
+ English/Japanese Text Tokenizer
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part III - Feature Engineering</li>
+
+
+
+ <li class="chapter " data-level="3.1" data-path="../ft_engineering/scaling.html">
+
+ <a href="../ft_engineering/scaling.html">
+
+
+ <b>3.1.</b>
+
+ Feature Scaling
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="3.2" data-path="../ft_engineering/hashing.html">
+
+ <a href="../ft_engineering/hashing.html">
+
+
+ <b>3.2.</b>
+
+ Feature Hashing
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="3.3" data-path="../ft_engineering/tfidf.html">
+
+ <a href="../ft_engineering/tfidf.html">
+
+
+ <b>3.3.</b>
+
+ TF-IDF calculation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="3.4" data-path="../ft_engineering/ft_trans.html">
+
+ <a href="../ft_engineering/ft_trans.html">
+
+
+ <b>3.4.</b>
+
+ FEATURE TRANSFORMATION
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="3.4.1" data-path="../ft_engineering/vectorizer.html">
+
+ <a href="../ft_engineering/vectorizer.html">
+
+
+ <b>3.4.1.</b>
+
+ Vectorize Features
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="3.4.2" data-path="../ft_engineering/quantify.html">
+
+ <a href="../ft_engineering/quantify.html">
+
+
+ <b>3.4.2.</b>
+
+ Quantify non-number features
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="3.5" data-path="../ft_engineering/feature_selection.html">
+
+ <a href="../ft_engineering/feature_selection.html">
+
+
+ <b>3.5.</b>
+
+ Feature selection
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part IV - Evaluation</li>
+
+
+
+ <li class="chapter " data-level="4.1" data-path="../eval/stat_eval.html">
+
+ <a href="../eval/stat_eval.html">
+
+
+ <b>4.1.</b>
+
+ Statistical evaluation of a prediction model
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="4.1.1" data-path="../eval/auc.html">
+
+ <a href="../eval/auc.html">
+
+
+ <b>4.1.1.</b>
+
+ Area Under the ROC Curve
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="4.2" data-path="../eval/rank.html">
+
+ <a href="../eval/rank.html">
+
+
+ <b>4.2.</b>
+
+ Ranking Measures
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="4.3" data-path="../eval/datagen.html">
+
+ <a href="../eval/datagen.html">
+
+
+ <b>4.3.</b>
+
+ Data Generation
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="4.3.1" data-path="../eval/lr_datagen.html">
+
+ <a href="../eval/lr_datagen.html">
+
+
+ <b>4.3.1.</b>
+
+ Logistic Regression data generation
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part V - Binary classification</li>
+
+
+
+ <li class="chapter " data-level="5.1" data-path="../binaryclass/a9a.html">
+
+ <a href="../binaryclass/a9a.html">
+
+
+ <b>5.1.</b>
+
+ a9a Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="5.1.1" data-path="../binaryclass/a9a_dataset.html">
+
+ <a href="../binaryclass/a9a_dataset.html">
+
+
+ <b>5.1.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.1.2" data-path="../binaryclass/a9a_lr.html">
+
+ <a href="../binaryclass/a9a_lr.html">
+
+
+ <b>5.1.2.</b>
+
+ Logistic Regression
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.1.3" data-path="../binaryclass/a9a_minibatch.html">
+
+ <a href="../binaryclass/a9a_minibatch.html">
+
+
+ <b>5.1.3.</b>
+
+ Mini-batch Gradient Descent
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="5.2" data-path="../binaryclass/news20.html">
+
+ <a href="../binaryclass/news20.html">
+
+
+ <b>5.2.</b>
+
+ News20 Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="5.2.1" data-path="../binaryclass/news20_dataset.html">
+
+ <a href="../binaryclass/news20_dataset.html">
+
+
+ <b>5.2.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.2.2" data-path="../binaryclass/news20_pa.html">
+
+ <a href="../binaryclass/news20_pa.html">
+
+
+ <b>5.2.2.</b>
+
+ Perceptron, Passive Aggressive
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.2.3" data-path="../binaryclass/news20_scw.html">
+
+ <a href="../binaryclass/news20_scw.html">
+
+
+ <b>5.2.3.</b>
+
+ CW, AROW, SCW
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.2.4" data-path="../binaryclass/news20_adagrad.html">
+
+ <a href="../binaryclass/news20_adagrad.html">
+
+
+ <b>5.2.4.</b>
+
+ AdaGradRDA, AdaGrad, AdaDelta
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="5.3" data-path="../binaryclass/kdd2010a.html">
+
+ <a href="../binaryclass/kdd2010a.html">
+
+
+ <b>5.3.</b>
+
+ KDD2010a Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="5.3.1" data-path="../binaryclass/kdd2010a_dataset.html">
+
+ <a href="../binaryclass/kdd2010a_dataset.html">
+
+
+ <b>5.3.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.3.2" data-path="../binaryclass/kdd2010a_scw.html">
+
+ <a href="../binaryclass/kdd2010a_scw.html">
+
+
+ <b>5.3.2.</b>
+
+ PA, CW, AROW, SCW
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="5.4" data-path="../binaryclass/kdd2010b.html">
+
+ <a href="../binaryclass/kdd2010b.html">
+
+
+ <b>5.4.</b>
+
+ KDD2010b Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="5.4.1" data-path="../binaryclass/kdd2010b_dataset.html">
+
+ <a href="../binaryclass/kdd2010b_dataset.html">
+
+
+ <b>5.4.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.4.2" data-path="../binaryclass/kdd2010b_arow.html">
+
+ <a href="../binaryclass/kdd2010b_arow.html">
+
+
+ <b>5.4.2.</b>
+
+ AROW
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="5.5" data-path="../binaryclass/webspam.html">
+
+ <a href="../binaryclass/webspam.html">
+
+
+ <b>5.5.</b>
+
+ Webspam Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="5.5.1" data-path="../binaryclass/webspam_dataset.html">
+
+ <a href="../binaryclass/webspam_dataset.html">
+
+
+ <b>5.5.1.</b>
+
+ Data pareparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="5.5.2" data-path="../binaryclass/webspam_scw.html">
+
+ <a href="../binaryclass/webspam_scw.html">
+
+
+ <b>5.5.2.</b>
+
+ PA1, AROW, SCW
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="5.6" data-path="../binaryclass/titanic_rf.html">
+
+ <a href="../binaryclass/titanic_rf.html">
+
+
+ <b>5.6.</b>
+
+ Kaggle Titanic Tutorial
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part VI - Multiclass classification</li>
+
+
+
+ <li class="chapter " data-level="6.1" data-path="../multiclass/news20.html">
+
+ <a href="../multiclass/news20.html">
+
+
+ <b>6.1.</b>
+
+ News20 Multiclass Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="6.1.1" data-path="../multiclass/news20_dataset.html">
+
+ <a href="../multiclass/news20_dataset.html">
+
+
+ <b>6.1.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.1.2" data-path="../multiclass/news20_one-vs-the-rest_dataset.html">
+
+ <a href="../multiclass/news20_one-vs-the-rest_dataset.html">
+
+
+ <b>6.1.2.</b>
+
+ Data preparation for one-vs-the-rest classifiers
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.1.3" data-path="../multiclass/news20_pa.html">
+
+ <a href="../multiclass/news20_pa.html">
+
+
+ <b>6.1.3.</b>
+
+ PA
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.1.4" data-path="../multiclass/news20_scw.html">
+
+ <a href="../multiclass/news20_scw.html">
+
+
+ <b>6.1.4.</b>
+
+ CW, AROW, SCW
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.1.5" data-path="../multiclass/news20_ensemble.html">
+
+ <a href="../multiclass/news20_ensemble.html">
+
+
+ <b>6.1.5.</b>
+
+ Ensemble learning
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.1.6" data-path="../multiclass/news20_one-vs-the-rest.html">
+
+ <a href="../multiclass/news20_one-vs-the-rest.html">
+
+
+ <b>6.1.6.</b>
+
+ one-vs-the-rest classifier
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="6.2" data-path="../multiclass/iris.html">
+
+ <a href="../multiclass/iris.html">
+
+
+ <b>6.2.</b>
+
+ Iris Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="6.2.1" data-path="../multiclass/iris_dataset.html">
+
+ <a href="../multiclass/iris_dataset.html">
+
+
+ <b>6.2.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.2.2" data-path="../multiclass/iris_scw.html">
+
+ <a href="../multiclass/iris_scw.html">
+
+
+ <b>6.2.2.</b>
+
+ SCW
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="6.2.3" data-path="../multiclass/iris_randomforest.html">
+
+ <a href="../multiclass/iris_randomforest.html">
+
+
+ <b>6.2.3.</b>
+
+ RandomForest
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part VII - Regression</li>
+
+
+
+ <li class="chapter " data-level="7.1" data-path="../regression/e2006.html">
+
+ <a href="../regression/e2006.html">
+
+
+ <b>7.1.</b>
+
+ E2006-tfidf regression Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="7.1.1" data-path="../regression/e2006_dataset.html">
+
+ <a href="../regression/e2006_dataset.html">
+
+
+ <b>7.1.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="7.1.2" data-path="../regression/e2006_arow.html">
+
+ <a href="../regression/e2006_arow.html">
+
+
+ <b>7.1.2.</b>
+
+ Passive Aggressive, AROW
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="7.2" data-path="../regression/kddcup12tr2.html">
+
+ <a href="../regression/kddcup12tr2.html">
+
+
+ <b>7.2.</b>
+
+ KDDCup 2012 track 2 CTR prediction Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="7.2.1" data-path="../regression/kddcup12tr2_dataset.html">
+
+ <a href="../regression/kddcup12tr2_dataset.html">
+
+
+ <b>7.2.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="7.2.2" data-path="../regression/kddcup12tr2_lr.html">
+
+ <a href="../regression/kddcup12tr2_lr.html">
+
+
+ <b>7.2.2.</b>
+
+ Logistic Regression, Passive Aggressive
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="7.2.3" data-path="../regression/kddcup12tr2_lr_amplify.html">
+
+ <a href="../regression/kddcup12tr2_lr_amplify.html">
+
+
+ <b>7.2.3.</b>
+
+ Logistic Regression with Amplifier
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="7.2.4" data-path="../regression/kddcup12tr2_adagrad.html">
+
+ <a href="../regression/kddcup12tr2_adagrad.html">
+
+
+ <b>7.2.4.</b>
+
+ AdaGrad, AdaDelta
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part VIII - Recommendation</li>
+
+
+
+ <li class="chapter " data-level="8.1" data-path="../recommend/cf.html">
+
+ <a href="../recommend/cf.html">
+
+
+ <b>8.1.</b>
+
+ Collaborative Filtering
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="8.1.1" data-path="../recommend/item_based_cf.html">
+
+ <a href="../recommend/item_based_cf.html">
+
+
+ <b>8.1.1.</b>
+
+ Item-based Collaborative Filtering
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="8.2" data-path="../recommend/news20.html">
+
+ <a href="../recommend/news20.html">
+
+
+ <b>8.2.</b>
+
+ News20 related article recommendation Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="8.2.1" data-path="../multiclass/news20_dataset.html">
+
+ <a href="../multiclass/news20_dataset.html">
+
+
+ <b>8.2.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.2.2" data-path="../recommend/news20_jaccard.html">
+
+ <a href="../recommend/news20_jaccard.html">
+
+
+ <b>8.2.2.</b>
+
+ LSH/Minhash and Jaccard Similarity
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.2.3" data-path="../recommend/news20_knn.html">
+
+ <a href="../recommend/news20_knn.html">
+
+
+ <b>8.2.3.</b>
+
+ LSH/Minhash and Brute-Force Search
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.2.4" data-path="../recommend/news20_bbit_minhash.html">
+
+ <a href="../recommend/news20_bbit_minhash.html">
+
+
+ <b>8.2.4.</b>
+
+ kNN search using b-Bits Minhash
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="8.3" data-path="../recommend/movielens.html">
+
+ <a href="../recommend/movielens.html">
+
+
+ <b>8.3.</b>
+
+ MovieLens movie recommendation Tutorial
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="8.3.1" data-path="../recommend/movielens_dataset.html">
+
+ <a href="../recommend/movielens_dataset.html">
+
+
+ <b>8.3.1.</b>
+
+ Data preparation
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.3.2" data-path="../recommend/movielens_mf.html">
+
+ <a href="../recommend/movielens_mf.html">
+
+
+ <b>8.3.2.</b>
+
+ Matrix Factorization
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.3.3" data-path="../recommend/movielens_fm.html">
+
+ <a href="../recommend/movielens_fm.html">
+
+
+ <b>8.3.3.</b>
+
+ Factorization Machine
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="8.3.4" data-path="../recommend/movielens_cv.html">
+
+ <a href="../recommend/movielens_cv.html">
+
+
+ <b>8.3.4.</b>
+
+ 10-fold Cross Validation (Matrix Factorization)
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part IX - Anomaly Detection</li>
+
+
+
+ <li class="chapter " data-level="9.1" data-path="../anomaly/lof.html">
+
+ <a href="../anomaly/lof.html">
+
+
+ <b>9.1.</b>
+
+ Outlier Detection using Local Outlier Factor (LOF)
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="9.2" data-path="../anomaly/sst.html">
+
+ <a href="../anomaly/sst.html">
+
+
+ <b>9.2.</b>
+
+ Change-Point Detection using Singular Spectrum Transformation (SST)
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="9.3" data-path="../anomaly/changefinder.html">
+
+ <a href="../anomaly/changefinder.html">
+
+
+ <b>9.3.</b>
+
+ ChangeFinder: Detecting Outlier and Change-Point Simultaneously
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part X - Clustering</li>
+
+
+
+ <li class="chapter active" data-level="10.1" data-path="lda.html">
+
+ <a href="lda.html">
+
+
+ <b>10.1.</b>
+
+ Latent Dirichlet Allocation
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part XI - GeoSpatial functions</li>
+
+
+
+ <li class="chapter " data-level="11.1" data-path="../geospatial/latlon.html">
+
+ <a href="../geospatial/latlon.html">
+
+
+ <b>11.1.</b>
+
+ Lat/Lon functions
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part XII - Hivemall on Spark</li>
+
+
+
+ <li class="chapter " data-level="12.1" data-path="../spark/getting_started/">
+
+ <a href="../spark/getting_started/">
+
+
+ <b>12.1.</b>
+
+ Getting Started
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="12.1.1" data-path="../spark/getting_started/installation.html">
+
+ <a href="../spark/getting_started/installation.html">
+
+
+ <b>12.1.1.</b>
+
+ Installation
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="12.2" data-path="../spark/binaryclass/">
+
+ <a href="../spark/binaryclass/">
+
+
+ <b>12.2.</b>
+
+ Binary Classification
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="12.2.1" data-path="../spark/binaryclass/a9a_df.html">
+
+ <a href="../spark/binaryclass/a9a_df.html">
+
+
+ <b>12.2.1.</b>
+
+ a9a Tutorial for DataFrame
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="12.3" data-path="../spark/binaryclass/">
+
+ <a href="../spark/binaryclass/">
+
+
+ <b>12.3.</b>
+
+ Regression
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="12.3.1" data-path="../spark/regression/e2006_df.html">
+
+ <a href="../spark/regression/e2006_df.html">
+
+
+ <b>12.3.1.</b>
+
+ E2006-tfidf regression Tutorial for DataFrame
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+ <li class="chapter " data-level="12.4" data-path="../spark/misc/misc.html">
+
+ <a href="../spark/misc/misc.html">
+
+
+ <b>12.4.</b>
+
+ Generic features
+
+ </a>
+
+
+
+ <ul class="articles">
+
+
+ <li class="chapter " data-level="12.4.1" data-path="../spark/misc/topk_join.html">
+
+ <a href="../spark/misc/topk_join.html">
+
+
+ <b>12.4.1.</b>
+
+ Top-k Join processing
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="12.4.2" data-path="../spark/misc/functions.html">
+
+ <a href="../spark/misc/functions.html">
+
+
+ <b>12.4.2.</b>
+
+ Other utility functions
+
+ </a>
+
+
+
+ </li>
+
+
+ </ul>
+
+ </li>
+
+
+
+
+ <li class="header">Part XIII - External References</li>
+
+
+
+ <li class="chapter " data-level="13.1" >
+
+ <a target="_blank" href="https://github.com/maropu/hivemall-spark">
+
+
+ <b>13.1.</b>
+
+ Hivemall on Apache Spark
+
+ </a>
+
+
+
+ </li>
+
+ <li class="chapter " data-level="13.2" >
+
+ <a target="_blank" href="https://github.com/daijyc/hivemall/wiki/PigHome">
+
+
+ <b>13.2.</b>
+
+ Hivemall on Apache Pig
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="divider"></li>
+
+ <li>
+ <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+ Published with GitBook
+ </a>
+ </li>
+</ul>
+
+
+ </nav>
+
+
+ </div>
+
+ <div class="book-body">
+
+ <div class="body-inner">
+
+
+
+<div class="book-header" role="navigation">
+
+
+ <!-- Title -->
+ <h1>
+ <i class="fa fa-circle-o-notch fa-spin"></i>
+ <a href=".." >Latent Dirichlet Allocation</a>
+ </h1>
+</div>
+
+
+
+
+ <div class="page-wrapper" tabindex="-1" role="main">
+ <div class="page-inner">
+
+<div id="book-search-results">
+ <div class="search-noresults">
+
+ <section class="normal markdown-section">
+
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<p>Topic modeling is a way to analyze massive documents by clustering them into some <strong><em>topics</em></strong>. In particular, <strong>Latent Dirichlet Allocation</strong> (LDA) is one of the most popular topic modeling techniques; papers introduce the method are as follows:</p>
+<ul>
+<li>D. M. Blei, et al. <a href="http://www.jmlr.org/papers/v3/blei03a.html" target="_blank">Latent Dirichlet Allocation</a>. Journal of Machine Learning Research 3, pp. 993-1022, 2003.</li>
+<li>M. D. Hoffman, et al. <a href="https://papers.nips.cc/paper/3902-online-learning-for-latent-dirichlet-allocation" target="_blank">Online Learning for Latent Dirichlet Allocation</a>. NIPS 2010.</li>
+</ul>
+<p>Hivemall enables you to analyze your data such as, but not limited to, documents based on LDA. This page gives usage instructions of the feature.</p>
+<!-- toc --><div id="toc" class="toc">
+
+<ul>
+<li><a href="#prepare-document-data">Prepare document data</a></li>
+<li><a href="#building-topic-models-and-finding-topic-words">Building Topic Models and Finding Topic Words</a></li>
+<li><a href="#predicting-topic-assignments-of-documents">Predicting Topic Assignments of Documents</a></li>
+</ul>
+
+</div><!-- tocstop -->
+<div class="panel panel-primary"><div class="panel-heading"><h3 class="panel-title" id="note"><i class="fa fa-edit"></i> Note</h3></div><div class="panel-body"><p>This feature is supported from Hivemall v0.5-rc.1 or later.</p></div></div>
+<h1 id="prepare-document-data">Prepare document data</h1>
+<p>Assume that we already have a table <code>docs</code> which contains many documents as string format:</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:center">docid</th>
+<th style="text-align:left">doc</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:left">"Fruits and vegetables are healthy."</td>
+</tr>
+<tr>
+<td style="text-align:center">2</td>
+<td style="text-align:left">"I like apples, oranges, and avocados. I do not like the flu or colds."</td>
+</tr>
+<tr>
+<td style="text-align:center">...</td>
+<td style="text-align:left">...</td>
+</tr>
+</tbody>
+</table>
+<p>Hivemall has several functions which are particularly useful for text processing. More specifically, by using <code>tokenize()</code> and <code>is_stopword()</code>, you can immediately convert the documents to <a href="https://en.wikipedia.org/wiki/Bag-of-words_model" target="_blank">bag-of-words</a>-like format:</p>
+<pre><code class="lang-sql">with word_counts as (
+ <span class="hljs-keyword">select</span>
+ docid,
+ feature(word, <span class="hljs-keyword">count</span>(word)) <span class="hljs-keyword">as</span> word_count
+ <span class="hljs-keyword">from</span> docs t1 LATERAL <span class="hljs-keyword">VIEW</span> explode(tokenize(doc, <span class="hljs-literal">true</span>)) t2 <span class="hljs-keyword">as</span> word
+ <span class="hljs-keyword">where</span>
+ <span class="hljs-keyword">not</span> is_stopword(word)
+ <span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span>
+ docid, word
+)
+<span class="hljs-keyword">select</span> docid, collect_set(word_count) <span class="hljs-keyword">as</span> feature
+<span class="hljs-keyword">from</span> word_counts
+<span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span> docid
+;
+</code></pre>
+<table>
+<thead>
+<tr>
+<th style="text-align:center">docid</th>
+<th style="text-align:left">feature</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:left">["fruits:1","healthy:1","vegetables:1"]</td>
+</tr>
+<tr>
+<td style="text-align:center">2</td>
+<td style="text-align:left">["apples:1","avocados:1","colds:1","flu:1","like:2","oranges:1"]</td>
+</tr>
+</tbody>
+</table>
+<div class="panel panel-primary"><div class="panel-heading"><h3 class="panel-title" id="note"><i class="fa fa-edit"></i> Note</h3></div><div class="panel-body"><p>It should be noted that, as long as your data can be represented as the feature format, LDA can be applied for arbitrary data as a generic clustering technique.</p></div></div>
+<h1 id="building-topic-models-and-finding-topic-words">Building Topic Models and Finding Topic Words</h1>
+<p>Each feature vector is input to the <code>train_lda()</code> function:</p>
+<pre><code class="lang-sql">with word_counts as (
+ <span class="hljs-keyword">select</span>
+ docid,
+ feature(word, <span class="hljs-keyword">count</span>(word)) <span class="hljs-keyword">as</span> word_count
+ <span class="hljs-keyword">from</span> docs t1 LATERAL <span class="hljs-keyword">VIEW</span> explode(tokenize(doc, <span class="hljs-literal">true</span>)) t2 <span class="hljs-keyword">as</span> word
+ <span class="hljs-keyword">where</span>
+ <span class="hljs-keyword">not</span> is_stopword(word)
+ <span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span>
+ docid, word
+)
+<span class="hljs-keyword">select</span>
+ train_lda(feature, <span class="hljs-string">"-topic 2 -iter 20"</span>) <span class="hljs-keyword">as</span> (label, word, lambda)
+<span class="hljs-keyword">from</span> (
+ <span class="hljs-keyword">select</span> docid, collect_set(word_count) <span class="hljs-keyword">as</span> feature
+ <span class="hljs-keyword">from</span> word_counts
+ <span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span> docid
+ <span class="hljs-keyword">order</span> <span class="hljs-keyword">by</span> docid
+) t
+;
+</code></pre>
+<p>Here, an option <code>-topic 2</code> specifies the number of topics we assume in the set of documents.</p>
+<p>Notice that <code>order by docid</code> ensures building a LDA model precisely in a single node. In case that you like to launch <code>train_lda</code> in parallel, following query hopefully returns similar (but might be slightly approximated) result:</p>
+<pre><code class="lang-sql">with word_counts as (
+ <span class="hljs-comment">-- same as above</span>
+)
+<span class="hljs-keyword">select</span>
+ label, word, <span class="hljs-keyword">avg</span>(lambda) <span class="hljs-keyword">as</span> lambda
+<span class="hljs-keyword">from</span> (
+ <span class="hljs-keyword">select</span>
+ train_lda(feature, <span class="hljs-string">"-topic 2 -iter 20"</span>) <span class="hljs-keyword">as</span> (label, word, lambda)
+ <span class="hljs-keyword">from</span> (
+ <span class="hljs-keyword">select</span> docid, collect_set(f) <span class="hljs-keyword">as</span> feature
+ <span class="hljs-keyword">from</span> word_counts
+ <span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span> docid
+ ) t1
+) t2
+<span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span> label, word
+<span class="hljs-keyword">order</span> <span class="hljs-keyword">by</span> lambda <span class="hljs-keyword">desc</span>
+;
+</code></pre>
+<p>Eventually, a new table <code>lda_model</code> is generated as shown below:</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:center">label</th>
+<th style="text-align:center">word</th>
+<th style="text-align:center">lambda</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">fruits</td>
+<td style="text-align:center">0.33372128</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">vegetables</td>
+<td style="text-align:center">0.33272517</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">healthy</td>
+<td style="text-align:center">0.33246377</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">flu</td>
+<td style="text-align:center">2.3617347E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">apples</td>
+<td style="text-align:center">2.1898883E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">oranges</td>
+<td style="text-align:center">1.8161473E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">like</td>
+<td style="text-align:center">1.7666373E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">avocados</td>
+<td style="text-align:center">1.726186E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">0</td>
+<td style="text-align:center">colds</td>
+<td style="text-align:center">1.037139E-4</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">colds</td>
+<td style="text-align:center">0.16622013</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">avocados</td>
+<td style="text-align:center">0.16618845</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">oranges</td>
+<td style="text-align:center">0.1661859</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">like</td>
+<td style="text-align:center">0.16618414</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">apples</td>
+<td style="text-align:center">0.16616651</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">flu</td>
+<td style="text-align:center">0.16615893</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">healthy</td>
+<td style="text-align:center">0.0012059759</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">vegetables</td>
+<td style="text-align:center">0.0010818697</td>
+</tr>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">fruits</td>
+<td style="text-align:center">6.080827E-4</td>
+</tr>
+</tbody>
+</table>
+<p>In the table, <code>label</code> indicates a topic index, and <code>lambda</code> is a value which represents how each word is likely to characterize a topic. That is, we can say that, in terms of <code>lambda</code>, top-N words are the <strong><em>topic words</em></strong> of a topic.</p>
+<p>Obviously, we can observe that topic <code>0</code> corresponds to document <code>1</code>, and topic <code>1</code> represents words in document <code>2</code>.</p>
+<h1 id="predicting-topic-assignments-of-documents">Predicting Topic Assignments of Documents</h1>
+<p>Once you have constructed topic models as described before, a function <code>lda_predict()</code> allows you to predict topic assignments of documents.</p>
+<p>For example, if we consider the <code>docs</code> table, the exactly same set of documents as used for training, probability that a document is assigned to a topic can be computed by:</p>
+<pre><code class="lang-sql">with test as (
+ <span class="hljs-keyword">select</span>
+ docid,
+ word,
+ <span class="hljs-keyword">count</span>(word) <span class="hljs-keyword">as</span> <span class="hljs-keyword">value</span>
+ <span class="hljs-keyword">from</span> docs t1 LATERAL <span class="hljs-keyword">VIEW</span> explode(tokenize(doc, <span class="hljs-literal">true</span>)) t2 <span class="hljs-keyword">as</span> word
+ <span class="hljs-keyword">where</span>
+ <span class="hljs-keyword">not</span> is_stopword(word)
+ <span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span>
+ docid, word
+)
+<span class="hljs-keyword">select</span>
+ t.docid,
+ lda_predict(t.word, t.<span class="hljs-keyword">value</span>, m.label, m.lambda, <span class="hljs-string">"-topic 2"</span>) <span class="hljs-keyword">as</span> probabilities
+<span class="hljs-keyword">from</span>
+ <span class="hljs-keyword">test</span> t
+ <span class="hljs-keyword">JOIN</span> lda_model m <span class="hljs-keyword">ON</span> (t.word = m.word)
+<span class="hljs-keyword">group</span> <span class="hljs-keyword">by</span>
+ t.docid
+;
+</code></pre>
+<table>
+<thead>
+<tr>
+<th style="text-align:center">docid</th>
+<th style="text-align:left">probabilities (sorted by probabilities)</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:left">[{"label":0,"probability":0.875},{"label":1,"probability":0.125}]</td>
+</tr>
+<tr>
+<td style="text-align:center">2</td>
+<td style="text-align:left">[{"label":1,"probability":0.9375},{"label":0,"probability":0.0625}]</td>
+</tr>
+</tbody>
+</table>
+<p>Importantly, an option <code>-topic</code> should be set to the same value as you set for training.</p>
+<p>Since the probabilities are sorted in descending order, a label of the most promising topic is easily obtained as:</p>
+<pre><code class="lang-sql"><span class="hljs-keyword">select</span> docid, probabilities[<span class="hljs-number">0</span>].label
+<span class="hljs-keyword">from</span> topic
+;
+</code></pre>
+<table>
+<thead>
+<tr>
+<th style="text-align:center">docid</th>
+<th style="text-align:center">label</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:center">1</td>
+<td style="text-align:center">0</td>
+</tr>
+<tr>
+<td style="text-align:center">2</td>
+<td style="text-align:center">1</td>
+</tr>
+</tbody>
+</table>
+<p>Of course, using the different set of documents for prediction is possible. Predicting topic assignments of newly observed documents should be more realistic scenario.</p>
+<p><div id="page-footer"><hr><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<p><sub><font color="gray">
+Apache Hivemall is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+</font></sub></p>
+</div></p>
+
+
+ </section>
+
+ </div>
+ <div class="search-results">
+ <div class="has-results">
+
+ <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+ <ul class="search-results-list"></ul>
+
+ </div>
+ <div class="no-results">
+
+ <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+
+ </div>
+ </div>
+</div>
+
+ </div>
+ </div>
+
+ </div>
+
+
+
+
+ </div>
+
+ <script>
+ var gitbook = gitbook || [];
+ gitbook.push(function() {
+ gitbook.page.hasChanged({"page":{"title":"Latent Dirichlet Allocation","level":"10.1","depth":1,"next":{"title":"Lat/Lon functions","level":"11.1","depth":1,"path":"geospatial/latlon.md","ref":"geospatial/latlon.md","articles":[]},"previous":{"title":"ChangeFinder: Detecting Outlier and Change-Point Simultaneously","level":"9.3","depth":1,"path":"anomaly/changefinder.md","ref":"anomaly/changefinder.md","articles":[]},"dir":"ltr"},"config":{"plugins":["theme-api","edit-link","github","splitter","sitemap","etoc","callouts","toggle-chapters","anchorjs","codeblock-filename","expandable-chapters","multipart","codeblock-filename","katex","emphasize","localized-footer"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"emphasize":{},"callouts":{},"etoc":{"maxdepth":3,"mindepth":1,"notoc":true},"github":{"url":"https://github.com/apache/incubat
or-hivemall/"},"splitter":{},"search":{},"downloadpdf":{"base":"https://github.com/apache/incubator-hivemall/docs/gitbook","label":"PDF","multilingual":false},"multipart":{},"localized-footer":{"filename":"FOOTER.md"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"katex":{},"fontsettings":{"theme":"white","family":"sans","size":2,"font":"sans"},"highlight":{},"codeblock-filename":{},"sitemap":{"hostname":"http://hivemall.incubator.apache.org/"},"theme-api":{"languages":[],"split":false,"theme":"dark"},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"Edit","base":"https://github.com/apache/incubator-hivemall/docs/gitbook"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":true},"anchorjs":
{"selector":"h1,h2,h3,*:not(.callout) > h4,h5"},"toggle-chapters":{},"expandable-chapters":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Hivemall User Manual","links":{"sidebar":{"<i class=\"fa fa-home\"></i> Home":"http://hivemall.incubator.apache.org/"}},"gitbook":"3.x.x","description":"User Manual for Apache Hivemall"},"file":{"path":"clustering/lda.md","mtime":"2017-04-20T07:32:10.000Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2017-04-24T10:44:53.699Z"},"basePath":"..","book":{"language":""}});
+ });
+ </script>
+</div>
+
+
+ <script src="../gitbook/gitbook.js"></script>
+ <script src="../gitbook/theme.js"></script>
+
+
+ <script src="../gitbook/gitbook-plugin-edit-link/plugin.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-github/plugin.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-splitter/splitter.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-etoc/plugin.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-toggle-chapters/toggle.js"></script>
+
+
+
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/3.1.1/anchor.min.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-anchorjs/anchor-style.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-expandable-chapters/expandable-chapters.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-search/search.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+
+
+
+ <script src="../gitbook/gitbook-plugin-theme-api/theme-api.js"></script>
+
+
+
+ </body>
+</html>
+
http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/blob/06c5398a/userguide/eval/auc.html
----------------------------------------------------------------------
diff --git a/userguide/eval/auc.html b/userguide/eval/auc.html
index 1c2d3b3..ade4826 100644
--- a/userguide/eval/auc.html
+++ b/userguide/eval/auc.html
@@ -1648,17 +1648,61 @@
- <li class="header">Part X - Hivemall on Spark</li>
+ <li class="header">Part X - Clustering</li>
- <li class="chapter " data-level="10.1" data-path="../spark/getting_started/">
+ <li class="chapter " data-level="10.1" data-path="../clustering/lda.html">
- <a href="../spark/getting_started/">
+ <a href="../clustering/lda.html">
<b>10.1.</b>
+ Latent Dirichlet Allocation
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part XI - GeoSpatial functions</li>
+
+
+
+ <li class="chapter " data-level="11.1" data-path="../geospatial/latlon.html">
+
+ <a href="../geospatial/latlon.html">
+
+
+ <b>11.1.</b>
+
+ Lat/Lon functions
+
+ </a>
+
+
+
+ </li>
+
+
+
+
+ <li class="header">Part XII - Hivemall on Spark</li>
+
+
+
+ <li class="chapter " data-level="12.1" data-path="../spark/getting_started/">
+
+ <a href="../spark/getting_started/">
+
+
+ <b>12.1.</b>
+
Getting Started
</a>
@@ -1668,12 +1712,12 @@
<ul class="articles">
- <li class="chapter " data-level="10.1.1" data-path="../spark/getting_started/installation.html">
+ <li class="chapter " data-level="12.1.1" data-path="../spark/getting_started/installation.html">
<a href="../spark/getting_started/installation.html">
- <b>10.1.1.</b>
+ <b>12.1.1.</b>
Installation
@@ -1688,12 +1732,12 @@
</li>
- <li class="chapter " data-level="10.2" data-path="../spark/binaryclass/">
+ <li class="chapter " data-level="12.2" data-path="../spark/binaryclass/">
<a href="../spark/binaryclass/">
- <b>10.2.</b>
+ <b>12.2.</b>
Binary Classification
@@ -1704,12 +1748,12 @@
<ul class="articles">
- <li class="chapter " data-level="10.2.1" data-path="../spark/binaryclass/a9a_df.html">
+ <li class="chapter " data-level="12.2.1" data-path="../spark/binaryclass/a9a_df.html">
<a href="../spark/binaryclass/a9a_df.html">
- <b>10.2.1.</b>
+ <b>12.2.1.</b>
a9a Tutorial for DataFrame
@@ -1724,12 +1768,12 @@
</li>
- <li class="chapter " data-level="10.3" data-path="../spark/binaryclass/">
+ <li class="chapter " data-level="12.3" data-path="../spark/binaryclass/">
<a href="../spark/binaryclass/">
- <b>10.3.</b>
+ <b>12.3.</b>
Regression
@@ -1740,12 +1784,12 @@
<ul class="articles">
- <li class="chapter " data-level="10.3.1" data-path="../spark/regression/e2006_df.html">
+ <li class="chapter " data-level="12.3.1" data-path="../spark/regression/e2006_df.html">
<a href="../spark/regression/e2006_df.html">
- <b>10.3.1.</b>
+ <b>12.3.1.</b>
E2006-tfidf regression Tutorial for DataFrame
@@ -1760,12 +1804,12 @@
</li>
- <li class="chapter " data-level="10.4" data-path="../spark/misc/misc.html">
+ <li class="chapter " data-level="12.4" data-path="../spark/misc/misc.html">
<a href="../spark/misc/misc.html">
- <b>10.4.</b>
+ <b>12.4.</b>
Generic features
@@ -1776,12 +1820,12 @@
<ul class="articles">
- <li class="chapter " data-level="10.4.1" data-path="../spark/misc/topk_join.html">
+ <li class="chapter " data-level="12.4.1" data-path="../spark/misc/topk_join.html">
<a href="../spark/misc/topk_join.html">
- <b>10.4.1.</b>
+ <b>12.4.1.</b>
Top-k Join processing
@@ -1791,6 +1835,21 @@
</li>
+ <li class="chapter " data-level="12.4.2" data-path="../spark/misc/functions.html">
+
+ <a href="../spark/misc/functions.html">
+
+
+ <b>12.4.2.</b>
+
+ Other utility functions
+
+ </a>
+
+
+
+ </li>
+
</ul>
@@ -1799,16 +1858,16 @@
- <li class="header">Part X - External References</li>
+ <li class="header">Part XIII - External References</li>
- <li class="chapter " data-level="11.1" >
+ <li class="chapter " data-level="13.1" >
<a target="_blank" href="https://github.com/maropu/hivemall-spark">
- <b>11.1.</b>
+ <b>13.1.</b>
Hivemall on Apache Spark
@@ -1818,12 +1877,12 @@
</li>
- <li class="chapter " data-level="11.2" >
+ <li class="chapter " data-level="13.2" >
<a target="_blank" href="https://github.com/daijyc/hivemall/wiki/PigHome">
- <b>11.2.</b>
+ <b>13.2.</b>
Hivemall on Apache Pig
@@ -2044,7 +2103,7 @@ Apache Hivemall is an effort undergoing incubation at The Apache Software Founda
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"Area Under the ROC Curve","level":"4.1.1","depth":2,"next":{"title":"Ranking Measures","level":"4.2","depth":1,"path":"eval/rank.md","ref":"eval/rank.md","articles":[]},"previous":{"title":"Statistical evaluation of a prediction model","level":"4.1","depth":1,"path":"eval/stat_eval.md","ref":"eval/stat_eval.md","articles":[{"title":"Area Under the ROC Curve","level":"4.1.1","depth":2,"path":"eval/auc.md","ref":"eval/auc.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["theme-api","edit-link","github","splitter","sitemap","etoc","callouts","toggle-chapters","anchorjs","codeblock-filename","expandable-chapters","multipart","codeblock-filename","katex","emphasize","localized-footer"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"emphasize":{},"callouts":{},"etoc":{"maxdepth":3,"mindepth":
1,"notoc":true},"github":{"url":"https://github.com/apache/incubator-hivemall/"},"splitter":{},"search":{},"downloadpdf":{"base":"https://github.com/apache/incubator-hivemall/docs/gitbook","label":"PDF","multilingual":false},"multipart":{},"localized-footer":{"filename":"FOOTER.md"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"katex":{},"fontsettings":{"theme":"white","family":"sans","size":2,"font":"sans"},"highlight":{},"codeblock-filename":{},"sitemap":{"hostname":"http://hivemall.incubator.apache.org/"},"theme-api":{"languages":[],"split":false,"theme":"dark"},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"Edit","base":"https://github.com/apache/incubator-hivemall/docs/gitbook"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/eb
ook.css","print":"styles/print.css"},"showLevel":true},"anchorjs":{"selector":"h1,h2,h3,*:not(.callout) > h4,h5"},"toggle-chapters":{},"expandable-chapters":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Hivemall User Manual","links":{"sidebar":{"<i class=\"fa fa-home\"></i> Home":"http://hivemall.incubator.apache.org/"}},"gitbook":"3.x.x","description":"User Manual for Apache Hivemall"},"file":{"path":"eval/auc.md","mtime":"2017-02-28T11:04:12.000Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2017-03-02T16:12:56.998Z"},"basePath":"..","book":{"language":""}});
+ gitbook.page.hasChanged({"page":{"title":"Area Under the ROC Curve","level":"4.1.1","depth":2,"next":{"title":"Ranking Measures","level":"4.2","depth":1,"path":"eval/rank.md","ref":"eval/rank.md","articles":[]},"previous":{"title":"Statistical evaluation of a prediction model","level":"4.1","depth":1,"path":"eval/stat_eval.md","ref":"eval/stat_eval.md","articles":[{"title":"Area Under the ROC Curve","level":"4.1.1","depth":2,"path":"eval/auc.md","ref":"eval/auc.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["theme-api","edit-link","github","splitter","sitemap","etoc","callouts","toggle-chapters","anchorjs","codeblock-filename","expandable-chapters","multipart","codeblock-filename","katex","emphasize","localized-footer"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"emphasize":{},"callouts":{},"etoc":{"maxdepth":3,"mindepth":
1,"notoc":true},"github":{"url":"https://github.com/apache/incubator-hivemall/"},"splitter":{},"search":{},"downloadpdf":{"base":"https://github.com/apache/incubator-hivemall/docs/gitbook","label":"PDF","multilingual":false},"multipart":{},"localized-footer":{"filename":"FOOTER.md"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"katex":{},"fontsettings":{"theme":"white","family":"sans","size":2,"font":"sans"},"highlight":{},"codeblock-filename":{},"sitemap":{"hostname":"http://hivemall.incubator.apache.org/"},"theme-api":{"languages":[],"split":false,"theme":"dark"},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"Edit","base":"https://github.com/apache/incubator-hivemall/docs/gitbook"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/eb
ook.css","print":"styles/print.css"},"showLevel":true},"anchorjs":{"selector":"h1,h2,h3,*:not(.callout) > h4,h5"},"toggle-chapters":{},"expandable-chapters":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Hivemall User Manual","links":{"sidebar":{"<i class=\"fa fa-home\"></i> Home":"http://hivemall.incubator.apache.org/"}},"gitbook":"3.x.x","description":"User Manual for Apache Hivemall"},"file":{"path":"eval/auc.md","mtime":"2017-02-28T11:04:12.000Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2017-04-24T10:44:53.699Z"},"basePath":"..","book":{"language":""}});
});
</script>
</div>