Skip to content

Commit d552b4a

Browse files
miriamsrtexasdiaz
andauthored
Updated AprilTag intro to reflect the current SDK (#384)
Co-authored-by: Danny Diaz <texasdiaz@gmail.com>
1 parent a37c7df commit d552b4a

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

docs/source/apriltag/vision_portal/apriltag_intro/apriltag-intro.rst

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -25,16 +25,16 @@ several resources:
2525
image processing library
2626
- myBlocks: custom Blocks created in OnBot Java (OBJ)
2727

28-
Now these three areas are provided, or bundled, in the new *FIRST* **Tech Challenge
29-
Software Development Kit (SDK), version 8.2**.
28+
Now these three areas are provided, or bundled, in the *FIRST* **Tech Challenge
29+
Software Development Kit (SDK), starting with version 8.2**.
3030

3131
Namely, key capabilities of **AprilTag** and **EasyOpenCV** are
3232
available to the Robot Controller (RC) and Driver Station (DS) apps,
3333
without special downloads. And AprilTag features are included in **FTC
3434
Blocks**, without needing custom myBlocks.
3535

36-
The AprilTag features work on Android RC phone cameras, and on webcams.
37-
A single OpMode can use AprilTag and TensorFlow Object Detection (TFOD).
36+
The AprilTag features work on webcams and on Android RC phone cameras.
37+
A single OpMode can use AprilTag and Color Processing.
3838

3939
In *FIRST* Tech Challenge, AprilTag is ready for the spotlight!
4040

@@ -66,7 +66,7 @@ containing information and designed for easy recognition.
6666
The above samples represent different formats, or **families**. A
6767
project typically uses a single AprilTag family.
6868

69-
This year, *FIRST* Tech Challenge uses a common family called **36h11**. A PDF
69+
*FIRST* Tech Challenge uses a common family called **36h11**. A PDF
7070
showing the numbers 0 through 20 from the 36h11 family can be downloaded here:
7171

7272
- :download:`AprilTag PDF 0-20 <files/AprilTag_0-20_family36h11.pdf>`
@@ -175,17 +175,17 @@ remains within the camera’s field of view. Namely, an OpMode “**while() loop
175175
should regularly read the updated pose data, to guide the robot’s driving
176176
actions.
177177

178-
The new SDK supports **multiple cameras**, switchable or simultaneous. This
178+
The SDK supports **multiple cameras**, switchable or simultaneous. This
179179
can help if the robot changes direction, or you wish to navigate using another
180-
AprilTag (or TensorFlow object).
180+
AprilTag (or Color Processing).
181181

182182
Other sensors can also be used for navigation, such as drive motor encoders,
183183
REV Hub IMU, deadwheel encoders, color/distance sensors, ultrasonic sensors,
184184
and more.
185185

186186
It’s also possible to evaluate **non-AprilTag images** from the same camera
187187
and/or a second camera. For example, the SDK can estimate the horizontal angle
188-
(or Bearing) of an object detected with **TensorFlow**, another vision
188+
(or Bearing) of an object detected with **Color Processing**, another vision
189189
technology employed in *FIRST* Tech Challenge. Advanced teams might consider
190190
active camera pointing control, to keep an AprilTag or other object in view.
191191

@@ -215,7 +215,7 @@ tags are **not** annotated by default with a colored border.
215215

216216
Note: **Camera Stream** displays a snapshot of the camera’s view, on the Driver
217217
Station device. It’s available only during the INIT phase of an OpMode, and
218-
also shows any AprilTag (or TFOD) annotations. Instructions are posted here:
218+
also shows any AprilTag (or Color Processing) annotations. Instructions are posted here:
219219

220220
- :ref:`Camera Stream Image Preview Documentation <hardware_and_software_configuration/configuring/configuring_external_webcam/configuring-external-webcam:image preview>`
221221

@@ -301,12 +301,12 @@ pose data in real-time to navigate to the desired location on the field.
301301
Vision processing can consume significant **CPU resources** and USB
302302
communications **bandwidth**. *FIRST* Tech Challenge teams may balance the
303303
benefits of higher resolution and speed (frames-per-second) against the risk of
304-
overloading CPU and bandwidth resources. The 8.2 SDK provides numerous tools to
304+
overloading CPU and bandwidth resources. The SDK 8.2 or later provides numerous tools to
305305
manage this balance:
306306

307307
- select the camera resolution
308308
- disable and enable the RC preview (called LiveView)
309-
- disable and enable the AprilTag (or TFOD) processor
309+
- disable and enable the AprilTag (or Color Processing) processor
310310
- close the camera stream
311311
- select a compressed video streaming format
312312
- measure frames-per-second
@@ -315,18 +315,18 @@ manage this balance:
315315

316316
**Option 3**
317317

318-
Clearer camera images can improve AprilTag (and TFOD) vision processing.
318+
Clearer camera images can improve AprilTag (and Color Processing) vision processing.
319319
The SDK offers powerful **webcam controls** (Exposure, Gain, Focus,
320-
and more), now available in FTC Blocks! These controls can be applied
320+
and more), also available in FTC Blocks! These controls can be applied
321321
under various lighting conditions.
322322

323-
Exposure and Gain are adjusted together. The new SDK offers Java Sample
323+
Exposure and Gain are adjusted together. The SDK offers Java Sample
324324
OpMode ``ConceptAprilTagOptimizeExposure.java``.
325325

326326
**Option 4**
327327

328328
The frame of reference described above in **AprilTag Axes** is
329-
calculated and provided by default in the new 8.2 SDK. Advanced teams
329+
calculated and provided by default in the 8.2 SDK or later. Advanced teams
330330
may prefer to perform their own pose calculations, based on **raw
331331
values** from the AprilTag/EasyOpenCV pipeline.
332332

@@ -381,7 +381,7 @@ Summary
381381
AprilTag is a popular camera-based technology, using a scanned image
382382
similar to a QR Code.
383383

384-
The new SDK version 8.2 now includes key capabilities of AprilTag and
384+
The SDK version 8.2 or later includes key capabilities of AprilTag and
385385
EasyOpenCV, a *FIRST* Tech Challenge-optimized interface with OpenCV for image
386386
processing. These methods are packaged for convenient use by **Java and Blocks
387387
programmers**.
@@ -399,8 +399,8 @@ Each camera requires **calibration data**, for a specific resolution, to
399399
provide good pose estimates.
400400

401401
Multiple cameras are supported, and a single OpMode can use AprilTag and
402-
TensorFlow Object Detection (TFOD). AprilTag detection is improved with
403-
webcam Camera Controls, now available also in FTC Blocks.
402+
Color Processing. AprilTag detection is improved with
403+
webcam Camera Controls, available also in FTC Blocks.
404404

405405
**In** *FIRST* **Tech Challenge, AprilTag is ready to take CENTERSTAGE!**
406406

0 commit comments

Comments
 (0)