Surface Lab 💎

get intersection for surfaces of revolution

Table of Contents

• Introduction
• Technologies
• Launch
• Screenshots
• Contributing
• To-do List
• Bugs
• License
• Acknowledgments

Introduction

Surfaces? Why would we ever need to get Intersection between ‘Surfaces’?

Think of OpenSCAD, SolidWorks, or Blinder. Can any of them work without the base knowledge of ‘intersection of surfaces’? Most probably no.
Great things are built step by step! 💪

The project was initiated in 2017, with two students : Mariam Mourad & [me][22]. Unfortunately, I got to know version control services a year later.

[22]:http://github.com/hagar-usama ‘Hagar Usama’

Technologies

The project is implemented in MATLAB, and:

• provides a Graphical User Interface (GUI)
• uses the very basic geometrical concepts

Launch

How to Launch?

Unluckily, you have to get MATLAB installed on your machine!

• Open the m file ‘intersection.m’, add it to the path, and run it

Can I use Octave?

As a Linux-biased one, I usually use Octave in my work. (MATLAB is now available on Linux BTW). But when it comes to GUI, I think this won’t work.

Screenshots

![Papillon][23]

![Tear][24]

![Big Heart][25]

[23]: https://github.com/Hagar-Usama/Surface-Lab/blob/master/Screenshots/Old_batch_2/final-like.JPG ‘papillon’

[24]: https://github.com/Hagar-Usama/Surface-Lab/blob/master/Screenshots/Old_batch_2/Captno8ure.JPG ‘Tear’

[25]: https://github.com/Hagar-Usama/Surface-Lab/blob/master/Screenshots/Old_batch_2/BigHeart.JPG ‘Big Heart’

Still Curious?
check 👉 [Screenshots][26]

[26]: https://github.com/Hagar-Usama/Surface-Lab/tree/master/Screenshots ‘Screenshots’

Contributing

To get started…

Step 1

• Option 1

  • 🍴 Fork this repo!

• Option 2

  • Clone this repo to your local machine using [Repo Link][27]

[27]: https://github.com/Hagar-Usama/Surface-Lab ‘Surface Intersection’

• option 3
  • Even if you do not code, send me your idea. I will credit you. And if you are interested, I will help you make it on your own!

Step 2

• HACK AWAY! 🔨🔨🔨

Step 3

• 🔃 Create a new pull request.

To-do List

• build a neat README
• rebuild the project in an open-source language (python)
• add classes
• add mouse events
• consider more descriptive captions

Bugs

• Some bugs are fixed. Yet, this needs some inspection 👀! Going back 3 years!🙆
• If you have run the project, let me know if you found any bugs.

License

MIT License

Acknowledgments 🙏

I am grateful for you all. So, thank you for:

• [May - June 2017] Mariam Mourad: being a co-founder for the project 🙈
• [May - June 2017] Prof Dr. Maged Naguib: supporting us by clarifying whatsoever is unclear
• [June 2019] Rana Mohmamed: providing me helpful material to revive the project