Welcome to the MandArt Discoveries repository! This repository is a shared space for storing and sharing discoveries made by exploring the Mandelbrot set, and its complement, and boundary using MandArt.
Click here to see some interesting discoveries:
We can explore the collections of MandArt by location. Each region has its own unique discoveries.
This map shows the locations of the discoveries in this repository. Vertical space is divided into 12 primary regions, lettered A through L. Vertical space is further divided into 4 subregions, lettered a through d. Horizontal space is divided into 20 primary regions, numbered 01 through 12. The bottom space reflects the top space; discoveries in the lower half of the map are reflections of discoveries in the upper half.
Click on the links below to view more from each region:
These discoveries were made using MandArt, available at the link below.
- MandArt (App Store) - runs on MacOS (v12+) - Released!
MandArt is s SwiftUI app for creating custom art with the Mandelbrot set. It'a available for macOS (v12+) devices for download from the Apple App Store. MandArt is not currently available for Windows or other non-compatible devices. Documentation about MandArt, the Mandelbrot set, and how to create custom MandArt is available on the web.
The Mandelbrot set has been called one of "the most complex objects" known. We could look forever and stil find new things.
Use the following site to explore some of the interesting patterns discovered so far. You can use this site to download the examples, color them as you like, or use them to start new journeys. If you make a new discovery or create custom art, we'd love to see it!
You can explore any of these discoveries in MandArt on your Mac. To open the document on your machine for further exploration, follow these steps.
- In GitHub, click the "Click here to download" link above an image to jump to the associated .mandart document file in GitHub.
- When viewing the GitHub page for the .mandart document:
- If using Chrome, click the download icon in the upper right corner to download the .mandart document to your machine.
- If using Safari, click "Raw", then use the Safari menu and click File / Save As and select the location where you'd like to save the .mandart document.
- On your Mac, double-click the .mandart document on your machine (use Finder as needed) to open the document in MandArt.
- In MandArt, you can use the various inputs to zoom out (-) and see where the landscape is located, modify the colors, or explore further.
With Chrome browser: when viewing the .mandart document file in GitHub, the download icon in the upper right of the document window looks like this:
We welcome contributions from anyone interested in sharing their MandArt discoveries with the community.
Before contributing, please review the following guidelines and requirements:
- Ensure that your .mandart document is valid and can be opened by the MandArt application.
- If your file contains confidential information, please do not include it in the repository.
We organize contributions by contributor. We'll ask for the following in addition to your .mandart document:
- Contributor username. Your GitHub account name works great.
- Your document should have a descriptive name with a .mandart extension.
- If you like, include a brief description when you share.
There are several ways to contribute.
If you would like to contribute to this repository, create a new issue (it's a lot like creating a new item on a task list) and attach your .mandart document to the issue.
To create a new issue:
- Click the "Issues" tab at the top of this GitHub repository page.
- Click the "New issue" button.
- Provide a title for your issue.
- In the issue description, include comments or a description as desired.
- Attach your .mandart document to the issue.
- Click the "Submit new issue" button.
We'll review your contribution, and on acceptance, merge it into the repository.
If you would like to contribute to this repository by adding a .mandart document, you can fork this repository and make a pull request with your changes.
To make a pull request:
- Fork this repository by clicking on the "Fork" button at the top of the repository page.
- Clone your forked repository to your local machine.
- Make your changes to the .mandart documents.
- Commit your changes with a clear and descriptive commit message.
- Push your changes to your forked repository.
- Click on the "New pull request" button on the original repository page.
- Select your forked repository and the branch containing your changes.
- Provide a clear and descriptive title and description for your pull request.
- Click on the "Create pull request" button.
We will review your pull request, and on acceptance, merge it into the repository.
Content is licensed under the MIT License. By contributing, you agree to license your contributions under the same.
We strive to maintain a welcoming and inclusive community for all contributors. We ask that all contributors follow our Code of Conduct.
If you have any questions or feedback about this repository, please visit our GitHub Discussions page. We look forward to hearing from you!
If you like MandArt, you might enjoy these resources as well.
- Mandelmap (Poster)
- Mandelbrot Set (Wikipedia
- The Hardest Trip - Mandelbrot Zoom (YouTube and others from Maths Town
(c) 2020-2024 All rights reserved