Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs #13

Merged
merged 1 commit into from
Aug 22, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,6 @@ tests/test_workspace
src/datagnosis/plugins/archived/
/data/*
!data/Brazil_covid19/

docs/generated/*
# Temp
.coveragerc
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ For benchmarking of the below methods see https://github.com/seedatnabeel/D-CAT.
| Method | Type| Description | Score | Reference |
| --- | --- | --- | --- | --- |
| Area Under the Margin (AUM) | Generic | Characterizes data examples based on the margin of a classifier – i.e. the difference between the logit values of the correct class and the next class. | Hard - low scores. | [AUM Paper](https://arxiv.org/abs/2001.10528) |
| Cleanlab *(rename) | Generic |Confident learning estimates the joint distribution of noisy and true labels — characterizing data as easy and hard for mislabeling. | Hard - low scores | [Cleanlab Paper](https://arxiv.org/pdf/1911.00068.pdf) |
| Confident Learning | Generic |Confident learning estimates the joint distribution of noisy and true labels — characterizing data as easy and hard for mislabeling. | Hard - low scores | [Confident Learning Paper](https://arxiv.org/pdf/1911.00068.pdf) |
| Conf Agree | Generic | Agreement measures the agreement of predictions on the same example. | Hard - low scores | [ Conf Agree Paper](https://arxiv.org/pdf/1910.13427.pdf)|
| Data IQ |Generic | Data-IQ computes the aleatoric uncertainty and confidence to characterize the data into easy, ambiguous and hard examples. | Hard - low confidence scores. High Aleatoric Uncertainty scores define ambiguous | [Data-IQ Paper](https://arxiv.org/abs/2210.13043) |
| Data Maps | Generic |Data Maps focuses on measuring variability (epistemic uncertainty) and confidence to characterize the data into easy, ambiguous and hard examples.|Hard - low confidence scores. High Epistemic Uncertainty scores define ambiguous| [Data-Maps Paper](https://arxiv.org/abs/2009.10795)|
Expand Down
11 changes: 11 additions & 0 deletions docs/source/_templates/module.rst_t
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{%- if show_headings %}
{{- [basename, "module"] | join(' ') | e | heading }}

{% endif -%}
.. uml:: {{ qualname }}
:classes:
.. automodule:: {{ qualname }}

{%- for option in automodule_options %}
:{{ option }}:
{%- endfor %}
25 changes: 25 additions & 0 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# stdlib
import subprocess

# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

Expand All @@ -11,6 +14,28 @@
author = "Rob Davis"
release = "0.0.1"


subprocess.run(
[
"sphinx-apidoc",
"--ext-autodoc",
"--ext-doctest",
"--ext-mathjax",
"--ext-viewcode",
"-e",
"-T",
"-M",
"-F",
"-P",
"-f",
"-o",
"generated",
"-t",
"_templates",
"../src/datagnosis/",
]
)

# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

Expand Down
30 changes: 0 additions & 30 deletions docs/source/datagnosis.md

This file was deleted.

39 changes: 0 additions & 39 deletions docs/source/datagnosis.plugins.core.md

This file was deleted.

111 changes: 0 additions & 111 deletions docs/source/datagnosis.plugins.generic.md

This file was deleted.

21 changes: 0 additions & 21 deletions docs/source/datagnosis.plugins.images.md

This file was deleted.

31 changes: 0 additions & 31 deletions docs/source/datagnosis.plugins.md

This file was deleted.

21 changes: 0 additions & 21 deletions docs/source/datagnosis.utils.md

This file was deleted.

Empty file added docs/source/datahandlers.rst
Empty file.
12 changes: 12 additions & 0 deletions docs/source/examples.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
Tutorials
============

Getting started
-----------------
.. toctree::
:glob:
:maxdepth: 2

Getting started with tabular data <Tutorials/tutorial_01_simple_tabular_example.ipynb>
Adding a new plugin <Tutorials/tutorial_02_images.ipynb>
Benchmarks <Tutorials/tutorial_03_tabular_COVID19_data.ipynb>
28 changes: 28 additions & 0 deletions docs/source/generators.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
Generators
============

General purpose
-----------------
.. toctree::
:glob:
:maxdepth: 2

Area Under the Margin (AUM) <generated/synthcity.plugins.generic.plugin_aum.rst>
Conf Agree <generated/synthcity.plugins.generic.plugin_conf_agree.rst>
Confident Learning <generated/synthcity.plugins.generic.plugin_confident_learning.rst>
Data IQ <generated/synthcity.plugins.generic.plugin_data_iq.rst>
Data Maps <generated/synthcity.plugins.generic.plugin_data_maps.rst>
Error L2-Norm (EL2N) <generated/synthcity.plugins.generic.plugin_el2n.rst>
Forgetting <generated/synthcity.plugins.generic.plugin_forgetting.rst>
Gradient Normed (GraNd) <generated/synthcity.plugins.generic.plugin_grand.rst>
Large Loss <generated/synthcity.plugins.generic.plugin_large_loss.rst>
Prototypicality <generated/synthcity.plugins.generic.plugin_prototypicality.rst>
Variance of Gradients (VOG) <generated/synthcity.plugins.generic.plugin_vog.rst>

Image specific
-----------------
.. toctree::
:glob:
:maxdepth: 2

Active Learning Guided by Local Sensitivity and Hardness (ALLSH) <generated/synthcity.plugins.privacy.plugin_allsh.rst>
20 changes: 0 additions & 20 deletions docs/source/index.md

This file was deleted.

Loading