diff --git a/LICENSE b/LICENSE index e972561..86a695b 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2019 Kristian Rother +Copyright (c) 2024 Kristian Rother Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index fc27400..bc05cd1 100644 --- a/README.md +++ b/README.md @@ -30,65 +30,64 @@ Next, try the examples and challenges. | Example | Topic | |-----------|--------| -| [Creating Images](grayscale/) | Create a grayscale image | -| [Color](rgb/) | Create a RGB image | -| [Random Blur](random_blur/) | Create random pixels | -| [Flags](flags/) | Slicing | -| [Repeat](repeat/) | Repeating tiles | +| [Creating Images](grayscale/README.rst) | Create a grayscale image | +| [Color](rgb/README.rst) | Create a RGB image | +| [Random Blur](random_blur/README.rst) | Create random pixels | +| [Flags](flags/README.rst) | Slicing | +| [Repeat](repeat/README.rst) | Repeating tiles | ## Elementary Geometry | Example | Topic | |-----------|--------| -| [Stars](stars/) | Indexing | -| [Lines](lines/) | Arithmetics | -| [Gradient](gradient/) | Linear space | -| [Triangles](triangles/) | Matrix operations | -| [Circles](circles/) | Euclidean Distances | -| [Mask](mask/) | Indexing | -| [Meme Generator](memegen/) | Adding text with Pillow | +| [Stars](stars/README.rst) | Indexing | +| [Lines](lines/README.rst) | Arithmetics | +| [Gradient](gradient/README.rst) | Linear space | +| [Triangles](triangles/README.rst) | Matrix operations | +| [Circles](circles/README.rst) | Euclidean Distances | +| [Mask](mask/README.rst) | Indexing | +| [Meme Generator](memegen/README.rst) | Adding text with Pillow | ## Machine Learning | Example | Topic | |-----------|--------| -| [K-Means](kmeans/) | Clustering | -| [Decision Tree](dtree/) | Color prediction | -| [Convolution](convolution/) | CNN kernel | -| [Monte Carlo](montecarlo/) | Sampling | +| [K-Means](kmeans/README.rst) | Clustering | +| [Decision Tree](dtree/README.rst) | Color prediction | +| [Convolution](convolution/README.rst) | CNN kernel | +| [Monte Carlo](montecarlo/README.rst) | Sampling | ## Effects | Example | Topic | |-----------|--------| -| [Rotation](rotate/) | Rotation figure | -| [Shadow](shadow/) | shadow using a mask | -| [Warhol](warhol/) | Color channels | -| [Puzzle](puzzle/) | vstack and hstack | -| [Contour Lines](contour/) | Gaussian Mixture | -| [Edge Detection](sobel/) | Sobel Operator | -| [Dragon Curve](dragon_curve/) | Recursive graphics | -| [Mandelbrot](mandelbrot/) | Recursive graphics | -| [Hexpanda](hexpanda/) | Hexbin plot | -| [Flower Assembly](flower_movie/) | Animation | -| [Vortex](vortex/) | Animation | -| [Sand blows away](sand/) | Animation | -| [Star Wars Titles](starwars/) | Animation | +| [Rotation](rotate/README.rst) | Rotation figure | +| [Shadow](shadow/README.rst) | shadow using a mask | +| [Warhol](warhol/README.rst) | Color channels | +| [Puzzle](puzzle/README.rst) | vstack and hstack | +| [Contour Lines](contour/README.rst) | Gaussian Mixture | +| [Edge Detection](sobel/README.rst) | Sobel Operator | +| [Dragon Curve](dragon_curve/README.rst) | Recursive graphics | +| [Mandelbrot](mandelbrot/README.rst) | Recursive graphics | +| [Hexpanda](hexpanda/README.rst) | Hexbin plot | + +## Animations ----- - -## More Generative Artists - -* [Beetlesbot by Bleeptrack](https://beetles.bleeptrack.de/) -* [Flowerbot by Bleeptrack](https://blptrck.uber.space/flower/) -* [GalaxyKate](http://galaxykate.com/) +| Example | Topic | +|-----------|--------| +| [Flower Assembly](flower_movie/README.rst) | puzzle | +| [Vortex](vortex/README.rst) | rotating parts | +| [Sand blows away](sand/README.rst) | moving particles | +| [Star Wars Titles](starwars/README.rst) | text moving in 3D | +| [Infinity Blossom](blossom/README.rst) | depth illusion | +| [Thank You](thank_you/README.rst) | scripted assembly | ---- ## Contact -(c) 2019 Dr. Kristian Rother (`krother@academis.eu`) +(c) 2024 Dr. Kristian Rother (`kristian.rother@posteo.de`) Distributed under the conditions of the MIT License. See `LICENSE` for details. diff --git a/_static/academis.css b/_static/academis.css new file mode 100644 index 0000000..bc2eacd --- /dev/null +++ b/_static/academis.css @@ -0,0 +1,7 @@ + +body { + margin-top: 250px; + margin-bottom: 250px; + background-image: url("academis_header.png"); + background-repeat: no-repeat; +} diff --git a/_static/academis_header.png b/_static/academis_header.png new file mode 100755 index 0000000..ec21d26 Binary files /dev/null and b/_static/academis_header.png differ diff --git a/_static/academis_logo.png b/_static/academis_logo.png new file mode 100755 index 0000000..f8d9185 Binary files /dev/null and b/_static/academis_logo.png differ diff --git a/conf.py b/conf.py index 8731b6e..a5961a8 100644 --- a/conf.py +++ b/conf.py @@ -7,9 +7,11 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information project = 'NumPy Graphics' -copyright = '2023, Kristian Rother' +copyright = '2024, Kristian Rother' author = 'Kristian Rother' release = '1.0' +html_title = f"{project}" + # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration @@ -21,31 +23,23 @@ 'myst_parser', ] -templates_path = ['_templates'] -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] +exclude_patterns = ['experimental', '_build', 'Thumbs.db', '.DS_Store'] -language = 'ls' +language = 'en' # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output -html_theme = 'academis_sphinx_theme' -html_theme_path = ['themes'] +html_theme = 'furo' html_static_path = ['_static'] -#html_logo = "_static/banner_wide.svg" +html_logo = "_static/academis_logo.png" html_favicon = "_static/favicon.ico" -html_sidebars = { - '**': [ - 'about.html', - 'localtoc.html', - 'searchbox.html', - ] -} +html_css_files = [ + "academis.css", +] html_theme_options = { - 'logo': 'academis.png', - 'github_user': 'krother', - 'github_repo': 'generative_art', - 'show_relbar_top' : True, - 'show_relbar_bottom' : True, -} + "source_repository": "https://github.com/krother/generative_art", + "source_branch": "main", + "source_directory": "", +} \ No newline at end of file diff --git a/dev_requirements.txt b/dev_requirements.txt index f342f0e..37e2198 100644 --- a/dev_requirements.txt +++ b/dev_requirements.txt @@ -2,4 +2,5 @@ sphinx sphinx-design sphinx-copybutton myst-parser -git+https://github.com/krother/academis_sphinx_theme.git +furo +#git+https://github.com/krother/academis_sphinx_theme.git diff --git a/index.rst b/index.rst index dd44e22..96bdde8 100644 --- a/index.rst +++ b/index.rst @@ -1,20 +1,18 @@ +:hide-toc: + Graphics with NumPy =================== - .. figure:: images/title.png :alt: title image -.. topic:: Introduction +In this tutorial you find NumPy exercises that create images. +It is meant as a gentle introduction to NumPy. It assumes that you have +made your first steps with Python already. To get the best out of it, +put it into practice immediately: - In this tutorial you find NumPy exercises that create images. - It is meant as a gentle introduction to NumPy. It assumes that you have - made your first steps with Python already. To get the best out of it, - put it into practice immediately: +**paint things – create art – have fun!** - **paint things – create art – have fun!** - ----- Installation ------------ @@ -90,38 +88,33 @@ Effects dragon_curve/README.rst mandelbrot/README.rst hexpanda/README.rst + +---- + +Animations +---------- + +.. toctree:: + :maxdepth: 1 + flower_movie/README.rst vortex/README.rst sand/README.rst starwars/README.rst blossom/README.rst - logo/README.rst - ----- - -More Generative Artists ------------------------ - -- `Beetlesbot by Bleeptrack `__ -- `Flowerbot by Bleeptrack `__ -- `GalaxyKate `__ + thank_you/README.rst ---- .. topic:: License - © 2023 Dr. Kristian Rother (`kristian.rother@posteo.de`) + © 2024 Dr. Kristian Rother (`kristian.rother@posteo.de`) Usable under the conditions of the MIT License. See :download:`LICENSE` for details. ----- - -References ----------- - -`The Brandenburg Gate -image `__ -is by Thomas Wolf, www.foto-tw.de / Wikimedia Commons / CC BY-SA 3.0 -Teaching Programming +.. topic:: References + `The Brandenburg Gate + image `__ + is by Thomas Wolf, www.foto-tw.de / Wikimedia Commons / CC BY-SA 3.0