From a03d642b9a4608d555a09fb7e9b37d24f46409d9 Mon Sep 17 00:00:00 2001 From: Shisato Yano Date: Sat, 21 Nov 2026 21:25:58 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=F0=9F=8E=A8=20Replace=20the=20social?= =?UTF-8?q?=20preview=20image=20and=20the=20sidebar=20logo?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The new designs are made outside the book build, so they are committed as images instead of being drawn by matplotlib at build time. Only the front page's banner is still drawn from the demos, so the script is renamed to banner.py. The logo already shows the title, so the theme's title text above it is turned off with logo_only. Co-Authored-By: Claude Opus 5.5 --- .gitignore | 3 +- README.md | 2 +- doc/_extra/logo.png | Bin 0 -> 26686 bytes doc/_extra/social_preview.png | Bin 0 -> 108221 bytes doc/banner.py | 58 ++++++++++++ doc/conf.py | 15 ++-- doc/social_preview.py | 162 ---------------------------------- 7 files changed, 68 insertions(+), 172 deletions(-) create mode 100644 doc/_extra/logo.png create mode 100644 doc/_extra/social_preview.png create mode 100644 doc/banner.py delete mode 100644 doc/social_preview.py diff --git a/.gitignore b/.gitignore index 4c738772..89b7b4d9 100644 --- a/.gitignore +++ b/.gitignore @@ -6,4 +6,5 @@ __pycache__/ .vscode/ doc/_build/ doc/**/figures/*.svg -doc/_extra/ +# Drawn by doc/banner.py at build time; the other files in doc/_extra are committed +doc/_extra/banner.png diff --git a/README.md b/README.md index d4f5b5c2..200c5787 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ **[Read the book](https://shisatoyano.github.io/AutonomousVehicleControlBeginnersGuide/)** · **[See all simulations](/doc/EXAMPLES.md)** · **[Quick start](#quick-start)** - + diff --git a/doc/_extra/logo.png b/doc/_extra/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..30161c13f31f8155fc1a2fbe0d6d9da069df67ee GIT binary patch literal 26686 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⋘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 F{{WkN>;C`% literal 0 HcmV?d00001 diff --git a/doc/_extra/social_preview.png b/doc/_extra/social_preview.png new file mode 100644 index 0000000000000000000000000000000000000000..9b2fde294602a2781ccf2b450a435c69a6d1d67a GIT binary patch literal 108221 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
cLq)Rx!P)Vc@D( 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

)C} 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 literal 0 HcmV?d00001 diff --git a/doc/banner.py b/doc/banner.py new file mode 100644 index 00000000..e86d8888 --- /dev/null +++ b/doc/banner.py @@ -0,0 +1,58 @@ +""" +banner.py + +Draws the banner of the book's front page (1280x360 px): a frame of the first four demos +shown at the top of the README. The book build saves it in doc/_extra + +Author: Shisato Yano +""" + +from pathlib import Path + +import matplotlib.pyplot as plt +from PIL import Image, ImageChops + +REPO_DIR = Path(__file__).absolute().parent.parent + +# The same demos, in the same order, as the grid at the top of README.md (the banner shows the first four) +DEMOS = [ + ("Localization: EKF vs UKF vs PF", "localization/ekf_ukf_pf_comparison/ekf_ukf_pf_comparison.gif"), + ("Path tracking: MPPI", "path_tracking/mppi_path_tracking/mppi_path_tracking.gif"), + ("Path planning: Hybrid A*", "path_planning/astar_hybrid_path_planning/astar_hybrid_navigate.gif"), + ("Mapping: NDT", "mapping/ndt_map_construction/ndt_map_construction.gif"), + ("Mapping: cost map", "mapping/cost_grid_map_construction/cost_grid_map_construction.gif"), + ("Perception: rectangle fitting", "perception/point_cloud_rectangle_fitting/point_cloud_rectangle_fitting.gif"), +] + + +def frame(gif_path: Path) -> Image.Image: + """A frame two thirds into the demo, when the result is mostly drawn, without its white margins""" + gif = Image.open(gif_path) + gif.seek(gif.n_frames * 2 // 3) + image = gif.convert("RGB") + # Some demos have an off-white background, so nearly white counts as margin too + difference = ImageChops.difference(image, Image.new("RGB", image.size, "white")).convert("L") + content = difference.point(lambda value: 255 if value > 16 else 0).getbbox() + return image.crop(content) if content else image + + +def draw_banner(out_path: Path) -> None: + """Save the banner of the front page (1280x360 px): the first four demos""" + fig = plt.figure(figsize=(12.8, 3.6), dpi=100, facecolor="white") + for i, (label, gif) in enumerate(DEMOS[:4]): + left = 0.01 + i * 0.25 + ax = fig.add_axes((left, 0.02, 0.23, 0.74)) + ax.imshow(frame(REPO_DIR / "src" / "simulations" / gif)) + ax.set_axis_off() + # The banner is shown at about half its width, so the labels are large and on two lines + fig.text(left + 0.115, 0.88, label.replace(": ", "\n"), ha="center", va="center", + fontsize=20, linespacing=1.3, color="#1f2933") + + out_path.parent.mkdir(parents=True, exist_ok=True) + fig.savefig(out_path, dpi=100, facecolor="white") + plt.close(fig) + + +if __name__ == "__main__": + extra_dir = Path(__file__).absolute().parent / "_extra" + draw_banner(extra_dir / "banner.png") diff --git a/doc/conf.py b/doc/conf.py index d5ded7a9..cb845484 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -39,9 +39,10 @@ html_title = "Autonomous Vehicle Control Beginners Guide" html_theme_options = { "navigation_depth": 3, + # The logo already shows the title, which the theme would otherwise repeat above it + "logo_only": True, } templates_path = ["_templates"] -# Drawn by social_preview.py at build time, like the banner of the front page html_logo = "_extra/logo.png" # Search engines and link previews: canonical URLs and sitemap.xml come from html_baseurl, @@ -53,7 +54,7 @@ ogp_site_url = BOOK_URL ogp_site_name = html_title ogp_description_length = 160 -# Drawn by social_preview.py at build time; also uploaded as the repository's social preview +# The preview image is also uploaded as the repository's social preview html_extra_path = ["_extra"] html_static_path = ["_static"] html_css_files = ["custom.css"] @@ -159,12 +160,10 @@ def set_front_page_context(app: Sphinx, pagename: str, templatename: str, context["metatags"] += f'\n' -def draw_social_preview(app: Sphinx, config) -> None: - import social_preview +def draw_banner(app: Sphinx, config) -> None: + import banner - social_preview.draw(DOC_DIR / "_extra" / "social_preview.png") - social_preview.draw_banner(DOC_DIR / "_extra" / "banner.png") - social_preview.draw_logo(DOC_DIR / "_extra" / "logo.png") + banner.draw_banner(DOC_DIR / "_extra" / "banner.png") def draw_figures(app: Sphinx) -> None: @@ -191,7 +190,7 @@ def draw_figures(app: Sphinx) -> None: def setup(app: Sphinx) -> None: app.connect("builder-inited", draw_figures) # Before Sphinx checks that html_extra_path exists (priority 800) - app.connect("config-inited", draw_social_preview, priority=100) + app.connect("config-inited", draw_banner, priority=100) app.connect("source-read", rewrite_links) app.connect("source-read", add_section_toctree) app.connect("html-page-context", set_front_page_context) diff --git a/doc/social_preview.py b/doc/social_preview.py deleted file mode 100644 index 21a1d3f3..00000000 --- a/doc/social_preview.py +++ /dev/null @@ -1,162 +0,0 @@ -""" -social_preview.py - -Draws the social preview image (1280x640 px): the title of the project and a -frame of the first four demos shown at the top of the README. The book build saves it in -doc/_extra, and it is published at the root of the web book. Also draws the banner of the -book's front page (the same demos without the title) and the logo of its sidebar - -Author: Shisato Yano -""" - -from pathlib import Path - -import matplotlib.pyplot as plt -from PIL import Image, ImageChops - -REPO_DIR = Path(__file__).absolute().parent.parent - -# The same demos, in the same order, as the grid at the top of README.md (the image shows the first four) -DEMOS = [ - ("Localization: EKF vs UKF vs PF", "localization/ekf_ukf_pf_comparison/ekf_ukf_pf_comparison.gif"), - ("Path tracking: MPPI", "path_tracking/mppi_path_tracking/mppi_path_tracking.gif"), - ("Path planning: Hybrid A*", "path_planning/astar_hybrid_path_planning/astar_hybrid_navigate.gif"), - ("Mapping: NDT", "mapping/ndt_map_construction/ndt_map_construction.gif"), - ("Mapping: cost map", "mapping/cost_grid_map_construction/cost_grid_map_construction.gif"), - ("Perception: rectangle fitting", "perception/point_cloud_rectangle_fitting/point_cloud_rectangle_fitting.gif"), -] -TITLE = "Autonomous Vehicle Control Beginners Guide" -SUBTITLE = "Learn self-driving car algorithms by building them: Python simulations and an open textbook" - - -def frame(gif_path: Path) -> Image.Image: - """A frame two thirds into the demo, when the result is mostly drawn, without its white margins""" - gif = Image.open(gif_path) - gif.seek(gif.n_frames * 2 // 3) - image = gif.convert("RGB") - # Some demos have an off-white background, so nearly white counts as margin too - difference = ImageChops.difference(image, Image.new("RGB", image.size, "white")).convert("L") - content = difference.point(lambda value: 255 if value > 16 else 0).getbbox() - return image.crop(content) if content else image - - -def draw(out_path: Path) -> None: - """Save the 1280x640 px preview image to out_path""" - fig = plt.figure(figsize=(12.8, 6.4), dpi=100, facecolor="white") - # GitHub's repository cards show the image at about 2.6:1, cropping the top and bottom - # 80 px of 640, so everything stays between y = 100 and 540 px - fig.text(0.5, 0.81, TITLE, ha="center", va="center", fontsize=30, fontweight="bold", color="#1f2933") - fig.text(0.5, 0.745, SUBTITLE, ha="center", va="center", fontsize=15, color="#52606d") - - for i, (label, gif) in enumerate(DEMOS[:4]): - left = 0.02 + i * 0.245 - ax = fig.add_axes((left, 0.17, 0.225, 0.5)) - ax.imshow(frame(REPO_DIR / "src" / "simulations" / gif)) - ax.set_axis_off() - fig.text(left + 0.1125, 0.685, label, ha="center", fontsize=12, color="#1f2933") - - out_path.parent.mkdir(parents=True, exist_ok=True) - fig.savefig(out_path, dpi=100, facecolor="white") - plt.close(fig) - - -def draw_banner(out_path: Path) -> None: - """Save the banner of the front page (1280x360 px): the four demos of the preview, without the title""" - fig = plt.figure(figsize=(12.8, 3.6), dpi=100, facecolor="white") - for i, (label, gif) in enumerate(DEMOS[:4]): - left = 0.01 + i * 0.25 - ax = fig.add_axes((left, 0.02, 0.23, 0.74)) - ax.imshow(frame(REPO_DIR / "src" / "simulations" / gif)) - ax.set_axis_off() - # The banner is shown at about half its width, so the labels are large and on two lines - fig.text(left + 0.115, 0.88, label.replace(": ", "\n"), ha="center", va="center", - fontsize=20, linespacing=1.3, color="#1f2933") - - out_path.parent.mkdir(parents=True, exist_ok=True) - fig.savefig(out_path, dpi=100, facecolor="white") - plt.close(fig) - - -def draw_logo(out_path: Path) -> None: - """ - Save the logo of the sidebar (600x300 px, transparent): a car on a curved road that - scans with a LiDAR, detects an obstacle and follows its planned path - """ - import numpy as np - - fig = plt.figure(figsize=(6.0, 3.0), dpi=100) - ax = fig.add_axes((0, 0, 1, 1)) - ax.set_xlim(0, 8) - ax.set_ylim(-1.7, 2.3) - ax.set_aspect("equal") - ax.set_axis_off() - - def course_y(x: np.ndarray | float) -> np.ndarray | float: - return np.sin(0.7 * x - 0.6) - - # The sidebar's header is blue, so the road is a light band and the sensing is drawn in white and yellow - x = np.linspace(-0.5, 8.5, 200) - ax.plot(x, course_y(x), color="#dbe9f6", linewidth=56, solid_capstyle="butt") - - # Planned path: dots along the course ahead of the car - x_path = np.arange(3.5, 8.2, 0.3) - ax.plot(x_path, course_y(x_path), "o", color="#1f2933", markersize=7, zorder=2) - - # Obstacle beside the road ahead, with the box that the detector fits to the LiDAR points - obstacle = (5.6, 0.2, 0.9, 0.9) # left, bottom, width, height - left, bottom, width, height = obstacle - ax.fill([left, left + width, left + width, left], [bottom, bottom, bottom + height, bottom + height], - color="#52606d", zorder=2) - ax.plot([left - 0.12, left + width + 0.12, left + width + 0.12, left - 0.12, left - 0.12], - [bottom - 0.12, bottom - 0.12, bottom + height + 0.12, bottom + height + 0.12, bottom - 0.12], - color="#ffcf33", linewidth=4, linestyle=(0, (3, 2)), zorder=4) - - x0 = 2.6 - y0 = course_y(x0) - yaw = np.arctan(0.7 * np.cos(0.7 * x0 - 0.6)) - - # LiDAR: rays stopped where they hit the obstacle - # from the LiDAR on the roof, 0.1 behind the car's center - sensor = np.array([x0 - 0.1 * np.cos(yaw), y0 - 0.1 * np.sin(yaw)]) - for angle in np.radians(np.linspace(-24, 24, 7)): - direction = np.array([np.cos(angle), np.sin(angle)]) - end, hit = sensor + 3.3 * direction, False - for distance in np.arange(0.0, 3.3, 0.02): - px, py = sensor + distance * direction - if left <= px <= left + width and bottom <= py <= bottom + height: - end, hit = np.array([px, py]), True - break - # Starts just outside the LiDAR's dot, so the rays visibly come from it - start = sensor + 0.22 * direction - ax.plot([start[0], end[0]], [start[1], end[1]], color="white", alpha=0.9, linewidth=3, zorder=7) - if hit: - ax.plot(*end, "o", color="#ffcf33", markersize=10, zorder=5) - - # The car: body and tires in the vehicle's frame, turned to the course's heading - rotation = np.array([[np.cos(yaw), -np.sin(yaw)], [np.sin(yaw), np.cos(yaw)]]) - - def place(outline_xy: list[list[float]]) -> tuple[np.ndarray, np.ndarray]: - points = rotation @ (0.8 * np.array(outline_xy)) - return points[0] + x0, points[1] + y0 - - for tire_x, tire_y in [(0.75, 0.45), (0.75, -0.45), (-0.75, 0.45), (-0.75, -0.45)]: - tx, ty = place([[tire_x - 0.25, tire_x + 0.25, tire_x + 0.25, tire_x - 0.25], - [tire_y - 0.1, tire_y - 0.1, tire_y + 0.1, tire_y + 0.1]]) - ax.fill(tx, ty, color="#1f2933", zorder=6) - bx, by = place([[-1.1, 1.1, 1.1, -1.1], [-0.42, -0.42, 0.42, 0.42]]) - ax.fill(bx, by, color="#e8505b", edgecolor="#1f2933", linewidth=2.5, zorder=6) - # The LiDAR on the roof - lx, ly = place([[-0.15], [0.0]]) - ax.plot(lx, ly, "o", color="#1f2933", markersize=15, zorder=8) - ax.plot(lx, ly, "o", color="#ffcf33", markersize=8, zorder=9) - - out_path.parent.mkdir(parents=True, exist_ok=True) - fig.savefig(out_path, dpi=100, transparent=True) - plt.close(fig) - - -if __name__ == "__main__": - extra_dir = Path(__file__).absolute().parent / "_extra" - draw(extra_dir / "social_preview.png") - draw_banner(extra_dir / "banner.png") - draw_logo(extra_dir / "logo.png")

Localization: EKF vs UKF vs PF
Localization: EKF vs UKF vs PF