piskvorky · tmylk · Jan 17, 2017 · Sep 25, 2016 · Sep 25, 2016 · Sep 27, 2016
diff --git a/docs/notebooks/atmodel_tests.ipynb b/docs/notebooks/atmodel_tests.ipynb
diff --git a/docs/notebooks/atmodel_tutorial.ipynb b/docs/notebooks/atmodel_tutorial.ipynb
diff --git a/docs/src/apiref.rst b/docs/src/apiref.rst
@@ -37,6 +37,7 @@ Modules:
     models/lsi_worker
     models/lda_dispatcher
     models/lda_worker
+    models/atmodel
     models/word2vec
     models/doc2vec
     models/phrases

diff --git a/docs/src/models/atmodel.rst b/docs/src/models/atmodel.rst
@@ -0,0 +1,9 @@
+:mod:`models.atmodel` -- Author-topic models
+======================================================
+
+.. automodule:: gensim.models.atmodel
+    :synopsis: Author-topic model
+    :members:
+    :inherited-members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/gensim/models/__init__.py b/gensim/models/__init__.py
@@ -16,6 +16,7 @@
 from .ldamulticore import LdaMulticore
 from .phrases import Phrases
 from .normmodel import NormModel
+from .atmodel import AuthorTopicModel
 from .ldaseqmodel import LdaSeqModel
 
 from . import wrappers

diff --git a/gensim/models/atmodel.py b/gensim/models/atmodel.py
diff --git a/gensim/models/ldamodel.py b/gensim/models/ldamodel.py
@@ -737,7 +737,8 @@ def bound(self, corpus, gamma=None, subsample_ratio=1.0):
             score += np.sum(gammaln(gammad) - gammaln(self.alpha))
             score += gammaln(np.sum(self.alpha)) - gammaln(np.sum(gammad))
 
-        # compensate likelihood for when `corpus` above is only a sample of the whole corpus
+        # Compensate likelihood for when `corpus` above is only a sample of the whole corpus. This ensures
+        # that the likelihood is always rougly on the same scale.
         score *= subsample_ratio
 
         # E[log p(beta | eta) - log q (beta | lambda)]; assumes eta is a scalar

diff --git a/gensim/test/test_atmodel.py b/gensim/test/test_atmodel.py