Metadata-Version: 2.1
Name: parea
Version: 0.1.0
Summary: The easiest way to calculate the projected/frontal area of an STL.
Home-page: https://github.com/nathanrooy/p-area
Author: Nathan A. Rooy
Author-email: nathanrooy@gmail.com
License: GPLv3
Project-URL: Code, https://github.com/nathanrooy/p-area
Project-URL: Issues, https://github.com/nathanrooy/p-area/issues
Description: <p align="center"><img src="https://raw.githubusercontent.com/nathanrooy/p-area/main/logo/logo.png"></p>
        
        [![gh-actions-ci](https://img.shields.io/github/workflow/status/nathanrooy/p-area/ci?style=flat-square)](https://github.com/nathanrooy/p-area/actions?query=workflow%3Aci)
        [![GitHub license](https://img.shields.io/github/license/nathanrooy/p-area?style=flat-square)](https://github.com/nathanrooy/p-area/blob/master/LICENSE)
        
        Most <a target="_blank" href="https://en.wikipedia.org/wiki/Lift_coefficient">lift</a> and <a target="_blank" href="https://en.wikipedia.org/wiki/Drag_coefficient">drag</a> calculations require the use of a frontal/projected area. This is normally not that big of a deal, especially when dealing with nice clean CAD files. Unfortunately, in fast-paced design environments (motorsport especially), you'll often get a collection of <a target="_blank" href="https://en.wikipedia.org/wiki/STL_(file_format)">STL</a> geometry files instead. This is annoying for a number of reasons, but mainly because there are several methods for computing the frontal area of an STL and all of them involve a fairly tedious/lengthy process. pArea aims to solve this with a single command.
        
        
        ### Installation
        ```pip install parea```
        
        ### Usage
        As a simple example, the <a target="_blank" href="https://github.com/nathanrooy/p-area/blob/main/tests/cube.stl">cube</a> STL located within the `tests` directory has a projected area of 4.0 along all three coordinate axes. To validate this, simply run the following (assuming you've downloaded cube.stl into your current working directory):
        
        ```python
        parea -stl cube.stl -x
        ```
        
        ### Options
        vectors: `-x`, `-y`, `-z`
        
        planes: `-yz`/`-zy`, `-xz`/`-zx`, `-xy`/`-yx`
        
        
        ### References
        - Computational Geometry: Algorithms and Applications (3rd Edition) by Mike de Borg, Otfried Cheong, Mark van Kreveld, and Mark Overmars
        - Computational Geometry in C (2nd Edition) by Joseph O'Rourke
        - Finite Element Mesh Generation by Daniel S.H. Lo
        
        
Platform: any
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
