Skip to content

Commit 10cf481

Browse files
committed
initial port of documentation to md, algorithms reference converted to md, template based on spark docs
1 parent e31abd5 commit 10cf481

24 files changed

+13442
-0
lines changed

docs/README.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# SystemML Documentation
2+
3+
The primary SystemML documentation is written in markdown (*.md) and can be converted to HTML using
4+
[Jekyll](http://jekyllrb.com).
5+
6+
Jekyll (and optionally Pygments) can be installed on the Mac OS in the following manner.
7+
8+
$ brew install ruby
9+
$ gem install jekyll
10+
$ gem install jekyll-redirect-from
11+
$ brew install python
12+
$ pip install Pygments
13+
14+
For installation on other platforms, please consult the Jekyll documentation.
15+
16+
To generate SystemML documentation in HTML, navigate to the ```docs``` folder, the root directory of the
17+
documentation. From there, you can have Jekyll convert the markdown files to HTML. If you run in server mode,
18+
Jekyll will serve up the generated documentation by default at http://127.0.0.1:4000. Modifications
19+
to *.md files will be converted to HTML and can be viewed in a web browser.
20+
21+
$ jekyll serve -w

docs/_config.yml

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
highlighter: pygments
2+
markdown: kramdown
3+
gems:
4+
- jekyll-redirect-from
5+
6+
# For some reason kramdown seems to behave differently on different
7+
# OS/packages wrt encoding. So we hard code this config.
8+
kramdown:
9+
entity_output: numeric
10+
11+
include:
12+
- _static
13+
- _modules
14+
15+
# These allow the documentation to be updated with newer releases
16+
SYSTEMML_VERSION: 5.2

docs/_layouts/global.html

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<!DOCTYPE html>
2+
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
3+
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
4+
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
5+
<!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]-->
6+
<head>
7+
<title>{{ page.title }} - SystemML {{site.SYSTEMML_VERSION}}</title>
8+
<meta charset="utf-8">
9+
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
10+
{% if page.description %}
11+
<meta name="description" content="{{page.description | replace: 'SYSTEMML_VERSION', site.SYSTEMML_VERSION}}">
12+
{% endif %}
13+
<meta name="viewport" content="width=device-width">
14+
<link rel="stylesheet" href="css/bootstrap.min.css">
15+
<link rel="stylesheet" href="css/bootstrap-responsive.min.css">
16+
<link rel="stylesheet" href="css/main.css">
17+
<link rel="stylesheet" href="css/pygments-default.css">
18+
<script src="js/vendor/modernizr-2.6.1-respond-1.1.0.min.js"></script>
19+
</head>
20+
<body>
21+
<!--[if lt IE 7]>
22+
<p class="chromeframe">You are using an outdated browser. <a href="http://browsehappy.com/">Upgrade your browser today</a> or <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to better experience this site.</p>
23+
<![endif]-->
24+
25+
<div class="navbar navbar-fixed-top" id="topbar">
26+
<div class="navbar-inner">
27+
<div class="container">
28+
<div class="brand" style="padding: 15px 0px; font-size: 20px; font-style: italic; font-weight: bold;"><a href="index.html">SystemML - {{site.SYSTEMML_VERSION}}</a>
29+
</div>
30+
<ul class="nav">
31+
<li><a href="index.html">Home</a></li>
32+
33+
<li class="dropdown">
34+
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation<b class="caret"></b></a>
35+
<ul class="dropdown-menu">
36+
37+
<li><a href="http://www.github.com/SparkTC/systemml">SystemML GitHub README</a></li>
38+
<li><a href="algorithms-reference.html">Algorithms Reference</a></li>
39+
<!-- <li><a href="dml-language-reference.html">DML Language Reference</a></li> -->
40+
<li class="divider"></li>
41+
<li>&nbsp;&nbsp;&nbsp;&nbsp; More Coming Soon...</li>
42+
</ul>
43+
</li>
44+
45+
</ul>
46+
</div>
47+
</div>
48+
</div>
49+
50+
<div class="container" id="content">
51+
{% if page.displayTitle %}
52+
<h1 class="title">{{ page.displayTitle }}</h1>
53+
{% else %}
54+
<h1 class="title">{{ page.title }}</h1>
55+
{% endif %}
56+
57+
{{ content }}
58+
59+
</div> <!-- /container -->
60+
61+
<script src="js/vendor/jquery-1.8.0.min.js"></script>
62+
<script src="js/vendor/bootstrap.min.js"></script>
63+
<script src="js/vendor/anchor.min.js"></script>
64+
<script src="js/main.js"></script>
65+
66+
<!-- MathJax Section -->
67+
<script type="text/x-mathjax-config">
68+
MathJax.Hub.Config({
69+
TeX: { equationNumbers: { autoNumber: "AMS" } }
70+
});
71+
</script>
72+
<script>
73+
// Note that we load MathJax this way to work with local file (file://), HTTP and HTTPS.
74+
// We could use "//cdn.mathjax...", but that won't support "file://".
75+
(function(d, script) {
76+
script = d.createElement('script');
77+
script.type = 'text/javascript';
78+
script.async = true;
79+
script.onload = function(){
80+
MathJax.Hub.Config({
81+
tex2jax: {
82+
inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ],
83+
displayMath: [ ["$$","$$"], ["\\[", "\\]"] ],
84+
processEscapes: true,
85+
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre']
86+
}
87+
});
88+
};
89+
script.src = ('https:' == document.location.protocol ? 'https://' : 'http://') +
90+
'cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML';
91+
d.getElementsByTagName('head')[0].appendChild(script);
92+
}(document));
93+
</script>
94+
</body>
95+
</html>

docs/algorithms-bibliography.md

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
layout: global
3+
title: SystemML Algorithms Reference - Bibliography
4+
displayTitle: <a href="algorithms-reference.html">SystemML Algorithms Reference</a>
5+
---
6+
7+
AcockStavig1979, Alan C. Acock and Gordon
8+
R. Stavig, A Measure of Association for Nonparametric
9+
Statistics, Social Forces, Oxford University
10+
Press, Volume 57, Number 4, June, 1979,
11+
1381--1386.
12+
13+
AgrawalKSX2002, Rakesh Agrawal and
14+
Jerry Kiernan and Ramakrishnan Srikant and Yirong Xu,
15+
Hippocratic Databases, Proceedings of the 28-th
16+
International Conference on Very Large Data Bases (VLDB 2002),
17+
Hong Kong, China, August 20--23, 2002,
18+
143--154.
19+
20+
Agresti2002, Alan Agresti, Categorical
21+
Data Analysis, Second Edition, Wiley Series in
22+
Probability and Statistics, Wiley-Interscience
23+
2002, 710.
24+
25+
AloiseDHP2009, Daniel Aloise and Amit
26+
Deshpande and Pierre Hansen and Preyas Popat, NP-hardness of
27+
Euclidean Sum-of-squares Clustering, Machine Learning,
28+
Kluwer Academic Publishers, Volume 75, Number 2,
29+
May, 2009, 245--248.
30+
31+
ArthurVassilvitskii2007,
32+
k-means++: The Advantages of Careful Seeding, David
33+
Arthur and Sergei Vassilvitskii, Proceedings of the 18th
34+
Annual ACM-SIAM Symposium on Discrete Algorithms (SODA 2007),
35+
January 7--9, 2007, New Orleans, LA,
36+
USA, 1027--1035.
37+
38+
Chapelle2007, Olivier Chapelle, Training a Support Vector Machine in the Primal, Neural Computation, 2007.
39+
40+
Cochran1954, William G. Cochran,
41+
Some Methods for Strengthening the Common $\chi^2$ Tests,
42+
Biometrics, Volume 10, Number 4, December
43+
1954, 417--451.
44+
45+
Gill2000, Jeff Gill, Generalized Linear
46+
Models: A Unified Approach, Sage University Papers Series on
47+
Quantitative Applications in the Social Sciences, Number 07-134,
48+
2000, Sage Publications, 101.
49+
50+
Hartigan1975, John A. Hartigan,
51+
Clustering Algorithms, John Wiley~&~Sons Inc.,
52+
Probability and Mathematical Statistics, April
53+
1975, 365.
54+
55+
Hsieh2008, C-J Hsieh, K-W Chang, C-J Lin, S. S. Keerthi and S. Sundararajan, A Dual Coordinate Descent Method for Large-scale Linear SVM, International Conference of Machine Learning (ICML), 2008.
56+
57+
Lin2008, Chih-Jen Lin and Ruby C. Weng and
58+
S. Sathiya Keerthi, Trust Region Newton Method for
59+
Large-Scale Logistic Regression, Journal of Machine Learning
60+
Research, April, 2008, Volume 9, 627--650.
61+
62+
McCallum1998, A. McCallum and K. Nigam, A comparison of event models for naive bayes text classification, AAAI-98 workshop on learning for text categorization, 1998.
63+
64+
McCullagh1989, Peter McCullagh and John Ashworth
65+
Nelder, Generalized Linear Models, Second Edition,
66+
Monographs on Statistics and Applied Probability, Number 37,
67+
1989, Chapman & Hall/CRC, 532.
68+
69+
Nelder1972, John Ashworth Nelder and Robert
70+
William Maclagan Wedderburn, Generalized Linear Models,
71+
Journal of the Royal Statistical Society, Series A
72+
(General), 1972, Volume 135, Number 3,
73+
370--384.
74+
75+
Nocedal1999, J. Nocedal and S. J. Wright, Numerical Optimization, Springer-Verlag, 1999.
76+
77+
Nocedal2006, Optimization Numerical Optimization,
78+
Jorge Nocedal and Stephen Wright, Springer Series
79+
in Operations Research and Financial Engineering, 664,
80+
Second Edition, Springer, 2006.
81+
82+
Russell2009, S. Russell and P. Norvig, Artificial Intelligence: A Modern Approach, Prentice Hall, 2009.
83+
84+
Scholkopf1995, B. Scholkopf, C. Burges and V. Vapnik, Extracting Support Data for a Given Task, International Conference on Knowledge Discovery and Data Mining (ICDM), 1995.
85+
86+
Stevens1946, Stanley Smith Stevens,
87+
On the Theory of Scales of Measurement, Science
88+
June 7, 1946, Volume 103, Number 2684,
89+
677--680.
90+
91+
Vetterling1992,
92+
W. T. Vetterling and B. P. Flannery,
93+
Multidimensions in Numerical Recipes in C - The Art in Scientific Computing, W. H. Press and S. A. Teukolsky (eds.), Cambridge University Press, 1992.

0 commit comments

Comments
 (0)