Update TensorFlow Tutorials (Part 1) (#219)

* Update TensorFlow Tutorials (Part 1)
FIRST-Tech-Challenge · Sep 13, 2023 · 08d6438 · 08d6438
1 parent 65fd742
commit 08d6438
Show file tree

Hide file tree

Showing 123 changed files with 730 additions and 237 deletions.
diff --git a/docs/source/cad_resources/index.rst b/docs/source/cad_resources/index.rst
@@ -32,7 +32,7 @@ Software for Intermediate Users
 *  :doc:`Autodesk Fusion 360 <autodesk/autodesk>` (Free to *FIRST* teams) (desktop)
 *  :doc:`Dassault Systemes 3DEXPERIENCE <solidworks/solidworks>` (Free to *FIRST* teams) (cloud)
 *  :doc:`PTC OnShape <ptc/ptc>` (Free to *FIRST* teams) (Cloud)
-*  `Trimble SketchUp <https://www.sketchup.com/>`__ (Free plans available) (desktop)
+*  `Trimble SketchUp <https://sketchup.com/>`__ (Free plans available) (desktop)
 
 Software for Professional Users
 

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -272,6 +272,7 @@
    "https://ftc-ml.firstinspires.org",
    r'https://github.com/.*#',
    r'https://www.solidworks.com/',
+   r'https://sketchup.com/',
    r'https://april.eecs.umich.edu/'
 ]
 

diff --git a/docs/source/ftc_ml/implement/android_studios/android-studios.rst b/docs/source/ftc_ml/implement/android_studios/android-studios.rst
@@ -1,6 +1,13 @@
 Android Studio
 ================
 
+.. warning::
+   This Tutorial is outdated due to the TensorFlow updates for the
+   VisionPortal. We are working on updating this tutorial, please
+   bear with us as we update it. For more information on TensorFlow
+   for Java, see the VisionPortal
+   :ref:`TensorFlow Processor Initialization <apriltag/vision_portal/vision_processor_init/vision-processor-init:tensorflow initialization - easy>`.
+
 It is assumed that you already know how to use Android Studio. If not,
 be sure to check out the :ref:`Android Studio Guide <programming_resources/android_studio_java/android-studio-tutorial:android studio programming tutorial>`
 document before proceeding.

diff --git a/docs/source/ftc_ml/implement/blocks/blocks.rst b/docs/source/ftc_ml/implement/blocks/blocks.rst
@@ -1,6 +1,13 @@
 Blocks
 =======
 
+.. warning::
+   This Tutorial is outdated due to the TensorFlow updates for the
+   VisionPortal. We are working on updating this tutorial, please
+   bear with us as we update it. For more information on using
+   custom TensorFlow models with Blocks, see the tutorial
+   `Custom TFOD Model with Blocks <https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Custom-TFOD-Model-with-Blocks>`__
+
 It is assumed that you already know how to use Blocks. If not, be sure
 to check out the :ref:`Blocks Programming
 Guide <programming_resources/blocks/blocks-tutorial:blocks programming tutorial>`

diff --git a/docs/source/ftc_ml/implement/obj/obj.rst b/docs/source/ftc_ml/implement/obj/obj.rst
@@ -1,6 +1,13 @@
 OnBot Java (OBJ)
 =================
 
+.. warning::
+   This Tutorial is outdated due to the TensorFlow updates for the
+   VisionPortal. We are working on updating this tutorial, please
+   bear with us as we update it. For more information on TensorFlow
+   for Java, see the VisionPortal
+   :ref:`TensorFlow Processor Initialization <apriltag/vision_portal/vision_processor_init/vision-processor-init:tensorflow initialization - easy>`.
+
 It is assumed that you already know how to use OnBot Java. If not, be
 sure to check out the :ref:`OnBot Java
 Guide <programming_resources/onbot_java/onbot-java-tutorial:onbot java programming tutorial>`

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -245,6 +245,16 @@ to see why.
 
                AprilTags
 
+         .. div:: col-sm pl-1 pr-1
+
+            .. button-ref:: programming_resources/vision/tensorflow_cs_2023/tensorflow-cs-2023
+               :ref-type: doc
+               :color: black
+               :outline:
+               :expand:
+
+               TensorFlow
+
          .. div:: col-sm pl-1 pr-1
 
             .. button-ref:: programming_resources/index

diff --git a/docs/source/programming_resources/index.rst b/docs/source/programming_resources/index.rst
@@ -80,6 +80,21 @@ Topics for programming with AprilTags
    Understanding AprilTag Values <../apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values>
    AprilTag Test Images <../apriltag/opmode_test_images/opmode-test-images>
 
+TensorFlow Programming
+~~~~~~~~~~~~~~~~~~~~~~
+
+Topics for programming with TensorFlow Object Detection (TFOD)
+
+.. toctree::
+   :maxdepth: 1
+   :titlesonly:
+
+   vision/tensorflow_cs_2023/tensorflow-cs-2023
+   vision/tensorflow_pp_2022/tensorflow_pp_2022
+   vision/tensorflow_ff_2021/tensorflow-ff-2021
+   vision/blocks_tfod_opmode/blocks-tfod-opmode
+   vision/java_tfod_opmode/java-tfod-opmode
+
 Vision Programming
 ~~~~~~~~~~~~~~~~~~~
 
@@ -90,10 +105,6 @@ Learning more about using vision
    :titlesonly:
 
    vision/vision_overview/vision-overview
-   vision/tensorflow_pp_2022/tensorflow_pp_2022
-   vision/blocks_tfod_opmode/blocks-tfod-opmode
-   vision/java_tfod_opmode/java-tfod-opmode
-   vision/tensorflow_ff_2021/tensorflow-ff-2021
    vision/webcam_controls/index
    Camera Calibration <vision/camera_calibration/camera-calibration>
 

diff --git a/...sources/tutorial_specific/blocks/blocks_reference/Blocks-Reference-Material.rst b/...sources/tutorial_specific/blocks/blocks_reference/Blocks-Reference-Material.rst
@@ -32,12 +32,12 @@ Technology Forum
 ~~~~~~~~~~~~~~~~
 
 Registered teams can create user accounts on the FIRST Tech Challenge
-forum. Teams can use the forum to ask questions and receive support from
-the FIRST Tech Challenge community.
+Community forum. Teams can use the forum to ask questions and receive 
+support from the FIRST Tech Challenge community.
 
 The technology forum can be found at the following address:
 
-https://ftcforum.firstinspires.org/forum/ftc-technology?156-FTC-Technology
+- https://ftc-community.firstinspires.org
 
 REV Robotics Expansion Hub Documentation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/...tutorial_specific/onbot_java/onbot_java_reference/OnBot-Java-Reference-Info.rst b/...tutorial_specific/onbot_java/onbot_java_reference/OnBot-Java-Reference-Info.rst
@@ -36,7 +36,7 @@ the FIRST Tech Challenge community.
 
 The technology forum can be found at the following address:
 
-https://ftcforum.firstinspires.org/forum/ftc-technology?156-FTC-Technology
+- http://ftc-community.firstinspires.org
 
 REV Robotics Expansion Hub Documentation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~