Skip to content

Commit 22dc4a4

Browse files
committed
added class documentation
1 parent 6393b3a commit 22dc4a4

File tree

9 files changed

+108
-10
lines changed

9 files changed

+108
-10
lines changed

ads/feature_store/docs/requirements.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sphinx_copybutton
66
sphinx_code_tabs
77
sphinx-autobuild
88
sphinx-autorun
9-
oracle_ads
9+
oracle_ads==2.9.0rc0
1010
furo
1111
IPython
1212
pandoc

ads/feature_store/docs/source/feature_group.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,7 @@ Use the ``get_validation_output()`` method of the ``FeatureGroup`` instance to f
220220
The ``get_validation_output()`` method has the following optional parameter:
221221

222222
- ``job_id: string``. ID of the feature group job.
223+
223224
``get_validation_output().to_pandas()`` Outputs the validation results for each expectation as Pandas dataframe.
224225

225226
.. image:: figures/validation_results.png

ads/feature_store/docs/source/feature_store.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ The following example queries a feature store using SQL:
9999
df = feature_store.sql(sql)
100100
101101
Create an Entity
102-
=============
102+
================
103103
Use the ``create_entity()`` method of the ``FeatureStore`` instance to create an ``Entity``.
104104

105105
.. code-block:: python3
@@ -108,7 +108,7 @@ Use the ``create_entity()`` method of the ``FeatureStore`` instance to create an
108108
feature_store.create_entity(name="<ENTITY_NAME>")
109109
110110
Create a Transformation
111-
=====================
111+
=======================
112112
Transformations in a feature store are the operations and processes applied to raw data to create, modify, or derive new features for use as inputs for machine learning models. These transformations are necessary for improving the quality, relevance, and usefulness of features that then enhance the performance of models.
113113
You can call the ``create_transformation()`` method of the FeatureStore instance to create a ``Transformation``.
114114

ads/feature_store/docs/source/index.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ Feature Store
4444

4545
statistics
4646
feature_validation
47+
data_versioning
4748
ui
4849

4950
.. toctree::
@@ -59,3 +60,15 @@ Feature Store
5960
:caption: Release notes:
6061

6162
release_notes
63+
64+
.. toctree::
65+
:hidden:
66+
:maxdepth: 5
67+
:caption: Classes:
68+
69+
module
70+
71+
License
72+
+++++++
73+
74+
Copyright (c) 2020, 2022 Oracle and/or its affiliates. Licensed under the `Universal Permissive License v1.0 <https://oss.oracle.com/licenses/upl/>`_
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
===================
2+
Class Documentation
3+
===================
4+
5+
ads.feature_store package
6+
=========================
7+
8+
.. automodule:: ads.feature_store.feature_group
9+
:members:
10+
:undoc-members:
11+
:show-inheritance:
12+
13+
.. automodule:: ads.feature_store.feature_group_job
14+
:members:
15+
:undoc-members:
16+
:show-inheritance:
17+
18+
.. automodule:: ads.feature_store.dataset
19+
:members:
20+
:undoc-members:
21+
:show-inheritance:
22+
23+
.. automodule:: ads.feature_store.dataset_job
24+
:members:
25+
:undoc-members:
26+
:show-inheritance:
27+
28+
.. automodule:: ads.feature_store.transformation
29+
:members:
30+
:undoc-members:
31+
:show-inheritance:
32+
33+
.. automodule:: ads.feature_store.statistics_config
34+
:members:
35+
:undoc-members:
36+
:show-inheritance:
37+
38+
.. automodule:: ads.feature_store.model_details
39+
:members:
40+
:undoc-members:
41+
:show-inheritance:
42+
43+
.. automodule:: ads.feature_store.input_feature_detail
44+
:members:
45+
:undoc-members:
46+
:show-inheritance:
47+
48+
.. automodule:: ads.feature_store.feature
49+
:members:
50+
:undoc-members:
51+
:show-inheritance:
52+
53+
.. automodule:: ads.feature_store.entity
54+
:members:
55+
:undoc-members:
56+
:show-inheritance:
57+
58+
59+
.. automodule:: ads.feature_store.feature_group_expectation
60+
:members:
61+
:undoc-members:
62+
:show-inheritance:
63+
64+
ads.feature_store.query package
65+
===============================
66+
67+
Submodules
68+
----------
69+
70+
ads.feature_store.query.filter
71+
------------------------------
72+
73+
.. automodule:: ads.feature_store.query.filter
74+
:members:
75+
:undoc-members:
76+
:show-inheritance:
77+
78+
ads.feature_store.query.join
79+
------------------------------
80+
.. automodule:: ads.feature_store.query.join
81+
:members:
82+
:undoc-members:
83+
:show-inheritance:

ads/feature_store/docs/source/quickstart.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ Quick start
77
.. code-block:: shell
88
99
odsc conda install -s fspyspark32_p38_cpu_v1
10+
1011
3. Download the notebook examples from the example notebook section.
1112

1213
.. seealso::

ads/feature_store/docs/source/release_notes.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ Release notes: July 5, 2023
105105
* [DOCS] Updated terraform default version as 1.1.x
106106

107107
1.0.0
108-
----
108+
-----
109109

110110
.. note::
111111

ads/feature_store/docs/source/terraform.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
===================================
1+
=====================================
22
Terraform: Setting Up a Feature Store
3-
===================================
3+
=====================================
44

55
The following shows a terraform stack deployment of the feature store resources.
66

@@ -12,7 +12,7 @@ Blue-green deployment is a strategy for releasing new versions of an application
1212
.. _User Policies:
1313

1414
Required Policies for a Terraform Stack
15-
=============================
15+
=======================================
1616

1717
Feature store requires the following policy statements to deploy the feature store in a Terraform stack:
1818

@@ -200,7 +200,7 @@ The following Terraform variables used in this stack are:
200200

201201

202202
User VCN Deployment
203-
===============================
203+
===================
204204
Bring your own database (BYODB) is not supported by feature store because it doesn't support private access using a private endpoint and private access gateway for ATP instances.
205205

206206
You can specify VCN details for the feature store to use an existing VCN. A Terraform stack feature store has the following Terraform VCN variables:
@@ -249,7 +249,7 @@ You can specify VCN details for the feature store to use an existing VCN. A Terr
249249

250250

251251
Onboarding a Database
252-
##########
252+
#####################
253253

254254
Specify the following details to onboard database instancesL
255255

ads/feature_store/docs/source/ui.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Statistical analysis of features helps uncover insights about their distribution
3434
.. image:: figures/stats_fg.png
3535

3636
Dataset
37-
======
37+
=======
3838
Datasets also support iterative experimentation, allowing data scientists to create various dataset configurations with different feature combinations and transformations, which facilites the discovery of the most valuable features for model training.
3939

4040
.. image:: figures/dataset.gif

0 commit comments

Comments
 (0)