Skip to content

Commit 55ec3d0

Browse files
author
cezary.maszczyk
committed
update docs for v2.1.24.0
1 parent 3fe2690 commit 55ec3d0

File tree

91 files changed

+25228
-10
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

91 files changed

+25228
-10
lines changed

docs/serve/index.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,7 @@ <h1>
127127
</a>
128128
</li>
129129

130+
130131
<li class="toctree-l1">
131132
<a class="reference internal" href="v2.1.24.0/index.html">
132133
v2.1.24.0 (latest)
@@ -144,6 +145,7 @@ <h1>
144145

145146

146147

148+
147149
</ul>
148150
</div>
149151
</section>

docs/serve/v2.1.24.0/.buildinfo

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Sphinx build info version 1
2+
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3+
config: 12f3af7734ee25ce1367bfd71b5b933c
4+
tags: 645f666f9bcd5a90fca523b33c5a78b7
Loading
Loading
Loading
Loading
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
2+
RuleKit
3+
========================================
4+
5+
This package is python wrapper for `RuleKit <https://github.com/adaa-polsl/RuleKit/>`__ library (a versatile tool for rule learning).
6+
Based on a sequential covering induction algorithm, it is suitable for:
7+
8+
- classification,
9+
10+
- regression,
11+
12+
- survival problems.
13+
14+
This wrapper aims to give an easy way to integrate RuleKit functionality into python projects and notebooks.
15+
All package models are writen to be compatible with scikit learn library.
16+
17+
18+
.. toctree::
19+
:maxdepth: 1
20+
:caption: Table of contents:
21+
22+
Quick start <./rst/quick_start.rst>
23+
Whats new <./rst/whats_new/Changes in this version.ipynb>
24+
Tutorials <./rst/tutorials.rst>
25+
Code documentation <./rst/autodoc.rst>
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
2+
Code documentation
3+
========================================
4+
5+
.. automodule:: rulekit.main
6+
:members:
7+
8+
.. toctree::
9+
:maxdepth: 1
10+
:caption: Table of contents:
11+
12+
Classification <./autodoc/classification.rst>
13+
Regression <./autodoc/regression.rst>
14+
Survival <./autodoc/survival.rst>
15+
Parameters <./autodoc/params.rst>
16+
Rules <./autodoc/rules.rst>
17+
Statistics <./autodoc/stats.rst>
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
2+
Classification
3+
========================================
4+
5+
.. autoclass:: rulekit.classification.RuleClassifier
6+
:members:
7+
:inherited-members:
8+
9+
.. autoclass:: rulekit.classification.ExpertRuleClassifier
10+
:members:
11+
:inherited-members:
Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
Parameters
2+
========================================
3+
4+
5+
.. data:: rulekit.operator.Data
6+
7+
alias of type Union[numpy.ndarray, pandas.core.frame.DataFrame, List]
8+
9+
.. automodule:: rulekit.params
10+
:exclude-members: Measures
11+
12+
.. autoclass:: Measures
13+
:show-inheritance:
14+
15+
.. autoattribute:: Accuracy
16+
17+
.. autoattribute:: BinaryEntropy
18+
19+
.. autoattribute:: C1
20+
21+
.. autoattribute:: C2
22+
23+
.. autoattribute:: CFoil
24+
25+
.. autoattribute:: CN2Significnce
26+
27+
.. autoattribute:: Correlation
28+
29+
.. autoattribute:: Coverage
30+
31+
.. autoattribute:: FBayesianConfirmation
32+
33+
.. autoattribute:: FMeasure
34+
35+
.. autoattribute:: FullCoverage
36+
37+
.. autoattribute:: GeoRSS
38+
39+
.. autoattribute:: GMeasure
40+
41+
.. autoattribute:: InformationGain
42+
43+
.. autoattribute:: JMeasure
44+
45+
.. autoattribute:: Kappa
46+
47+
.. autoattribute:: Klosgen
48+
49+
.. autoattribute:: Laplace
50+
51+
.. autoattribute:: Lift
52+
53+
.. autoattribute:: LogicalSufficiency
54+
55+
.. autoattribute:: MEstimate
56+
57+
.. autoattribute:: MutualSupport
58+
59+
.. autoattribute:: Novelty
60+
61+
.. autoattribute:: OddsRatio
62+
63+
.. autoattribute:: OneWaySupport
64+
65+
.. autoattribute:: PawlakDependencyFactor
66+
67+
.. autoattribute:: Q2
68+
69+
.. autoattribute:: Precision
70+
71+
.. autoattribute:: RelativeRisk
72+
73+
.. autoattribute:: Ripper
74+
75+
.. autoattribute:: RuleInterest
76+
77+
.. autoattribute:: RSS
78+
79+
.. autoattribute:: SBayesian
80+
81+
.. autoattribute:: Sensitivity
82+
83+
.. autoattribute:: Specificity
84+
85+
.. autoattribute:: TwoWaySupport
86+
87+
.. autoattribute:: WeightedLaplace
88+
89+
.. autoattribute:: WeightedRelativeAccuracy
90+
91+
.. autoattribute:: YAILS
92+
93+
.. autoattribute:: LogRank
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
Regression
2+
==========
3+
4+
.. autoclass:: rulekit.regression.RuleRegressor
5+
:members:
6+
:inherited-members:
7+
8+
.. autoclass:: rulekit.regression.ExpertRuleRegressor
9+
:members:
10+
:inherited-members:
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Rules
2+
=====
3+
4+
.. automodule:: rulekit.rules
5+
:members:
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Statistics
2+
==========
3+
4+
.. automodule:: rulekit.stats
5+
:members:
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
Survival
2+
==========
3+
4+
.. autoclass:: rulekit.survival.SurvivalRules
5+
:members:
6+
:inherited-members:
7+
8+
.. autoclass:: rulekit.survival.ExpertSurvivalRules
9+
:members:
10+
:inherited-members:
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
2+
Quick start
3+
========================================
4+
5+
.. warning::
6+
This package is a wrapper for Java library, and requires Java Development Kit version 8
7+
or later to be installed on the computer. Both Open JDK and Oracle implementations are supported.
8+
9+
If you don't have JDK installed on your computer you can quickly set it up using
10+
:ref:`install-jdk<https://pypi.org/project/install-jdk/>` package.
11+
12+
.. code-block:: bash
13+
14+
pip install install-jdk
15+
16+
.. code-block:: python
17+
18+
import jdk
19+
20+
jdk.install('11', jre=True)
21+
22+
Installation
23+
-------------
24+
25+
.. code-block:: bash
26+
27+
pip install rulekit
28+
29+
.. note::
30+
31+
To check if everything was installed correctly call:
32+
33+
.. code-block:: python
34+
35+
import rulekit
36+
rulekit.__version__
37+
38+
It should run without errors and print package version.
39+
40+
Package usage
41+
--------------------
42+
43+
Now we are finally ready to use rulekit package and its models.
44+
45+
.. code-block:: python
46+
47+
from sklearn import datasets
48+
from rulekit import RuleKit
49+
from rulekit.classification import RuleClassifier
50+
51+
iris = datasets.load_iris()
52+
X = iris.data
53+
y = iris.target
54+
55+
classifier = RuleClassifier()
56+
classifier.fit(X, y)
57+
58+
prediction = classifier.predict(X)
59+
60+
from sklearn.metrics import accuracy_score
61+
62+
print('Accuracy: ', accuracy_score(y, prediction))
63+
64+
65+
As you may noticed, training and usage of rulekit models is the same as in scikit learn. This
66+
mean you easily can use scikit: metrics, cross-validation, hyper-parameters tuning etc.
67+
68+
69+
For more examples head to :doc:`Tutorials <./tutorials>` section.
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
2+
Tutorials
3+
=========
4+
5+
.. toctree::
6+
:maxdepth: 1
7+
:caption: Table of contents:
8+
9+
Classification <./tutorials/classification.ipynb>
10+
Regression <./tutorials/regression.ipynb>
11+
Survival <./tutorials/survival.ipynb>
12+
Expert Rules <./tutorials/expert_rules.ipynb>

0 commit comments

Comments
 (0)