Skip to content

Commit cf0c491

Browse files
committed
Merge remote-tracking branch 'origin/develop' into production
2 parents 4f99a31 + 20e4482 commit cf0c491

File tree

203 files changed

+11067
-5212
lines changed

Some content is hidden

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

203 files changed

+11067
-5212
lines changed

docs/README.md

+5-6
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Create Automatic Documentation for the Peter Algorithm with Sphinx
1+
# Create Automatic Documentation for the PITA Algorithm with Sphinx
22

3-
The documentation for the Peter Algorithm can be generated automatically using Sphinx, a powerful documentation generation tool for Python. For a high quality result, proper doc-strings are essential since Sphinx uses them to generate the documentation.
3+
The documentation for the PITA Algorithm can be generated automatically using Sphinx, a powerful documentation generation tool for Python. For a high quality result, proper doc-strings are essential since Sphinx uses them to generate the documentation.
44

55
## Installation
66

@@ -16,10 +16,10 @@ To create the documentation, follow these steps:
1616
1. From within the root directory of the project run `sphinx-quickstart docs`. Answer "yes" to the first prompt and customize the rest according to your preferences.
1717
2. After running the quickstart command, generate the documentation by running `sphinx-build -b html docs/source/ docs/build/html`. This will generate the necessary files for the documentation in the "build" and "source" folders.
1818
3. Configure the `conf.py` file in the "docs/source":
19-
- Add the `peters_algorithm` folder to the system path
19+
- Add the `pita_algorithm` folder to the system path
2020
- Apply the installed theme
2121
- Use relevant extensions such as 'sphinx.ext.duration', 'sphinx.ext.autodoc', 'sphinx.ext.napoleon', 'sphinx.ext.autosummary', and 'sphinx.ext.viewcode'
22-
4. Run `sphinx-apidoc -M -P -e -d 5 -f -o docs/source/ peters_algorithm/` from the root folder to generate API documentation for the `peters_algorithm` module. The individual flags mean:
22+
4. Run `sphinx-apidoc -M -P -e -d 5 -f -o docs/source/ pita_algorithm/` from the root folder to generate API documentation for the `pita_algorithm` module. The individual flags mean:
2323
- -M: put module documentation before submodule documentation
2424
- -P: include “_private” modules
2525
- -e: put documentation for each module on its own page to correctly display .py files as submodules
@@ -30,8 +30,7 @@ To create the documentation, follow these steps:
3030
6. Open `docs/build/html/index.html` to view the generated documentation.
3131

3232
## Steps for Updating Documentation
33-
0. Only after the first pull of the repository (since the build folder is ignored by git), run `sphinx-build -b html docs/source/ docs/build/html` to generate the necessary files for the documentation in the "build" folder.
34-
1. Run `sphinx-apidoc -M -P -e -d 5 -f -o docs/source/ peters_algorithm/` from the root folder to generate API documentation for the `peters_algorithm` module.
33+
1. Run `sphinx-apidoc -M -P -e -d 5 -f -o docs/source/ pita_algorithm/` from the root folder to generate API documentation for the `pita_algorithm` module.
3534
2. Run `make html` from within the "docs" folder to generate the HTML files.
3635
3. Open `docs/build/html/index.html` to view the generated documentation.
3736

53.6 KB
Binary file not shown.

docs/build/doctrees/index.doctree

-41 Bytes
Binary file not shown.

docs/build/doctrees/install.doctree

-41 Bytes
Binary file not shown.

docs/build/doctrees/modules.doctree

-51 Bytes
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
3.82 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
3.7 KB
Binary file not shown.
13.1 KB
Binary file not shown.
Binary file not shown.
3.43 KB
Binary file not shown.
Binary file not shown.

docs/build/doctrees/usage.doctree

-41 Bytes
Binary file not shown.

docs/build/html/.buildinfo

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 8584697138549918ce8720dd45c3ab5a
3+
config: 55b04df860f88de021d9826d3a0cc08e
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/build/html/_modules/index.html

+21-19
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@
101101
<p class="caption" role="heading"><span class="caption-text">PITA Algorithm Docs</span></p>
102102
<ul>
103103
<li class="toctree-l1"><a class="reference internal" href="../modules.html">API Reference</a><ul>
104-
<li class="toctree-l2"><a class="reference internal" href="../peters_algorithm.html">peters_algorithm package</a></li>
104+
<li class="toctree-l2"><a class="reference internal" href="../pita_algorithm.html">pita_algorithm package</a></li>
105105
</ul>
106106
</li>
107107
<li class="toctree-l1"><a class="reference external" href="https://github.com/microcosmAI/s.peters_algorithm/issues">Open Issues</a></li>
@@ -123,24 +123,26 @@
123123

124124
<h1>All modules for which code is available</h1>
125125
<ul><li><a href="_abc.html">_abc</a></li>
126-
<li><a href="peters_algorithm/base/assembler.html">peters_algorithm.base.assembler</a></li>
127-
<li><a href="peters_algorithm/base/asset_parsing/mujoco_loader.html">peters_algorithm.base.asset_parsing.mujoco_loader</a></li>
128-
<li><a href="peters_algorithm/base/asset_parsing/mujoco_object.html">peters_algorithm.base.asset_parsing.mujoco_object</a></li>
129-
<li><a href="peters_algorithm/base/asset_parsing/parser.html">peters_algorithm.base.asset_parsing.parser</a></li>
130-
<li><a href="peters_algorithm/base/asset_placement/abstract_placer.html">peters_algorithm.base.asset_placement.abstract_placer</a></li>
131-
<li><a href="peters_algorithm/base/asset_placement/abstract_rule.html">peters_algorithm.base.asset_placement.abstract_rule</a></li>
132-
<li><a href="peters_algorithm/base/asset_placement/border_placer.html">peters_algorithm.base.asset_placement.border_placer</a></li>
133-
<li><a href="peters_algorithm/base/asset_placement/boundary_rule.html">peters_algorithm.base.asset_placement.boundary_rule</a></li>
134-
<li><a href="peters_algorithm/base/asset_placement/fixed_placer.html">peters_algorithm.base.asset_placement.fixed_placer</a></li>
135-
<li><a href="peters_algorithm/base/asset_placement/min_distance_rule.html">peters_algorithm.base.asset_placement.min_distance_rule</a></li>
136-
<li><a href="peters_algorithm/base/asset_placement/random_placer.html">peters_algorithm.base.asset_placement.random_placer</a></li>
137-
<li><a href="peters_algorithm/base/asset_placement/validator.html">peters_algorithm.base.asset_placement.validator</a></li>
138-
<li><a href="peters_algorithm/base/world_container/abstract_container.html">peters_algorithm.base.world_container.abstract_container</a></li>
139-
<li><a href="peters_algorithm/base/world_container/area.html">peters_algorithm.base.world_container.area</a></li>
140-
<li><a href="peters_algorithm/base/world_container/environment.html">peters_algorithm.base.world_container.environment</a></li>
141-
<li><a href="peters_algorithm/pita.html">peters_algorithm.pita</a></li>
142-
<li><a href="peters_algorithm/utils/config_reader.html">peters_algorithm.utils.config_reader</a></li>
143-
<li><a href="peters_algorithm/utils/json_exporter.html">peters_algorithm.utils.json_exporter</a></li>
126+
<li><a href="pita_algorithm/base/assembler.html">pita_algorithm.base.assembler</a></li>
127+
<li><a href="pita_algorithm/base/asset_parsing/mujoco_loader.html">pita_algorithm.base.asset_parsing.mujoco_loader</a></li>
128+
<li><a href="pita_algorithm/base/asset_parsing/mujoco_object.html">pita_algorithm.base.asset_parsing.mujoco_object</a></li>
129+
<li><a href="pita_algorithm/base/asset_parsing/parser.html">pita_algorithm.base.asset_parsing.parser</a></li>
130+
<li><a href="pita_algorithm/base/asset_placement/abstract_placer.html">pita_algorithm.base.asset_placement.abstract_placer</a></li>
131+
<li><a href="pita_algorithm/base/asset_placement/abstract_rule.html">pita_algorithm.base.asset_placement.abstract_rule</a></li>
132+
<li><a href="pita_algorithm/base/asset_placement/border_placer.html">pita_algorithm.base.asset_placement.border_placer</a></li>
133+
<li><a href="pita_algorithm/base/asset_placement/boundary_rule.html">pita_algorithm.base.asset_placement.boundary_rule</a></li>
134+
<li><a href="pita_algorithm/base/asset_placement/fixed_placer.html">pita_algorithm.base.asset_placement.fixed_placer</a></li>
135+
<li><a href="pita_algorithm/base/asset_placement/min_distance_mujoco_physics_rule.html">pita_algorithm.base.asset_placement.min_distance_mujoco_physics_rule</a></li>
136+
<li><a href="pita_algorithm/base/asset_placement/min_distance_rule.html">pita_algorithm.base.asset_placement.min_distance_rule</a></li>
137+
<li><a href="pita_algorithm/base/asset_placement/random_placer.html">pita_algorithm.base.asset_placement.random_placer</a></li>
138+
<li><a href="pita_algorithm/base/asset_placement/validator.html">pita_algorithm.base.asset_placement.validator</a></li>
139+
<li><a href="pita_algorithm/base/world_sites/abstract_site.html">pita_algorithm.base.world_sites.abstract_site</a></li>
140+
<li><a href="pita_algorithm/base/world_sites/area.html">pita_algorithm.base.world_sites.area</a></li>
141+
<li><a href="pita_algorithm/base/world_sites/environment.html">pita_algorithm.base.world_sites.environment</a></li>
142+
<li><a href="pita_algorithm/pita.html">pita_algorithm.pita</a></li>
143+
<li><a href="pita_algorithm/utils/config_reader.html">pita_algorithm.utils.config_reader</a></li>
144+
<li><a href="pita_algorithm/utils/json_exporter.html">pita_algorithm.utils.json_exporter</a></li>
145+
<li><a href="pita_algorithm/utils/multivariate_uniform_distribution.html">pita_algorithm.utils.multivariate_uniform_distribution</a></li>
144146
</ul>
145147

146148

0 commit comments

Comments
 (0)