# BSpy
Library for manipulating and rendering B-spline curves, surfaces, and multidimensional manifolds with non-uniform knots in each dimension.
The [Manifold](https://ericbrec.github.io/BSpy/bspy/manifold.html) abstract base class for [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) and [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html).
The [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html) class has a method to fit multidimensional data for scalar and vector functions of single and multiple variables. It also can fit splines to functions, to solutions for ordinary differential equations (ODEs), and to geodesics.
Spline has methods to create points, lines, circular arcs, spheres, cones, cylinders, tori, ruled surfaces, surfaces of revolution, and four-sided patches.
Other methods add, subtract, and multiply splines, as well as confine spline curves to a given range.
There are methods to evaluate spline values, derivatives, normals, integrals, continuity, curvature, and the Jacobian, as well as methods that return spline representations of derivatives, normals, integrals, graphs, and convolutions.
In addition, there are methods to manipulate the domain of splines, including trim, join, split, reparametrize, transpose, reverse, add and remove knots, elevate and extrapolate, and fold and unfold.
There are methods to manipulate the range of splines, including dot product, cross product, translate, rotate, scale, and transform.
Finally, there are methods to compute the zeros and contours of a spline and to intersect two splines.
Splines can be saved and loaded in json format.
The [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) class has methods to create individual hyperplanes in any dimension, along with axis-aligned hyperplanes and hypercubes.
The [Solid](https://ericbrec.github.io/BSpy/bspy/solid.html) class has methods to construct n-dimensional solids from trimmed [Manifold](https://ericbrec.github.io/BSpy/bspy/manifold.html) boundaries. Each solid consists of a list of boundaries and a Boolean value that indicates if the solid contains infinity. Each [Boundary](https://ericbrec.github.io/BSpy/bspy/solid.html) consists of a manifold (currently a [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) or [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html)) and a domain solid that trims the manifold. Solids have methods to form the intersection, union, difference, and complement of solids. There are methods to compute point containment, winding numbers, surface integrals, and volume integrals. There are also methods to translate, transform, and slice solids. Solids can be saved and loaded in json format.
The [SplineBlock](https://ericbrec.github.io/BSpy/bspy/spline_block.html) class has methods to process an array-like collection of splines that represent a system of equations. There are highly-optimized methods to compute the contours and zeros of a spline block, as well as a variety of methods to manipulate and evaluate a spline block and its derivatives.
The [BSpyConvert](https://pypi.org/project/BSpyConvert/) package converts BSpy splines and solid models to and from [OpenCascade (OCCT)](https://dev.opencascade.org/) equivalents and a variety of geometry and CAD file formats, including STEP, IGES, and STL.
The [SplineOpenGLFrame](https://ericbrec.github.io/BSpy/bspy/splineOpenGLFrame.html) class is an
[OpenGLFrame](https://pypi.org/project/pyopengltk/) with custom shaders to render spline curves and surfaces. Spline surfaces with more
than 3 dependent variables will have their added dimensions rendered as colors (up to 6 dependent variables are supported). Only tested on Windows systems.
The [Viewer](https://ericbrec.github.io/BSpy/bspy/viewer.html) class is a
[tkinter.Tk](https://docs.python.org/3/library/tkinter.html) app that hosts a
[SplineOpenGLFrame](https://ericbrec.github.io/BSpy/bspy/splineOpenGLFrame.html),
a tree view full of solids and splines, and a set of controls to adjust and view the selected solids and splines. Only tested on Windows systems.
The [Graphics](https://ericbrec.github.io/BSpy/bspy/viewer.html#Graphics) class is a graphics engine to display splines.
It launches a [Viewer](https://ericbrec.github.io/BSpy/bspy/viewer.html) and issues commands to the viewer for use
in [jupyter](https://jupyter.org/) notebooks and other scripting environments. Only tested on Windows systems.
The full documentation for BSpy can be found [here](https://ericbrec.github.io/BSpy), its GitHub project can be found
[here](https://github.com/ericbrec/BSpy), a test suite can be found [here](https://github.com/ericbrec/BSpy/tree/main/tests), and
a set of examples, including a jupyter notebook, can be found [here](https://github.com/ericbrec/BSpy/tree/main/examples).
### Release 3.0 breaking changes
* Removed accuracy as a member of Spline
* Spline.common_basis is now a static method (see documentation for details)
* Spline.least_squares changed arguments (see documentation for details)
* Spline.load always returns a list of splines
### Release 4.0 breaking changes
* Removed Spline blossom method
* Removed DrawableSpline class
* Changed bspyApp class name to Viewer
* Changed Viewer listbox to use extended selection (shift and ctrl keys)
* Changed bspyGraphics class name to Graphics
* Moved DrawableSpine methods for adjusting spline appearance to Viewer (see documentation for details)
* Spline.bspline_values changed arguments (see documentation for details)
* Spline.intersect changed return values (see documentation for details)
Raw data
{
"_id": null,
"home_page": "http://github.com/ericbrec/BSpy",
"name": "bspy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.0",
"maintainer_email": null,
"keywords": "bspline, B-spline, nub, solid, solid modeling, geometry, csg, opengl, tkinter",
"author": "Eric Brechner",
"author_email": "ericbrec@msn.com",
"download_url": "https://files.pythonhosted.org/packages/be/a7/7cbac7edabd6145342fd460f21b02f2082b97c65525eed76d6818512d27a/bspy-4.3.tar.gz",
"platform": null,
"description": "# BSpy\r\nLibrary for manipulating and rendering B-spline curves, surfaces, and multidimensional manifolds with non-uniform knots in each dimension.\r\n\r\nThe [Manifold](https://ericbrec.github.io/BSpy/bspy/manifold.html) abstract base class for [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) and [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html).\r\n\r\nThe [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html) class has a method to fit multidimensional data for scalar and vector functions of single and multiple variables. It also can fit splines to functions, to solutions for ordinary differential equations (ODEs), and to geodesics. \r\nSpline has methods to create points, lines, circular arcs, spheres, cones, cylinders, tori, ruled surfaces, surfaces of revolution, and four-sided patches. \r\nOther methods add, subtract, and multiply splines, as well as confine spline curves to a given range. \r\nThere are methods to evaluate spline values, derivatives, normals, integrals, continuity, curvature, and the Jacobian, as well as methods that return spline representations of derivatives, normals, integrals, graphs, and convolutions. \r\nIn addition, there are methods to manipulate the domain of splines, including trim, join, split, reparametrize, transpose, reverse, add and remove knots, elevate and extrapolate, and fold and unfold. \r\nThere are methods to manipulate the range of splines, including dot product, cross product, translate, rotate, scale, and transform. \r\nFinally, there are methods to compute the zeros and contours of a spline and to intersect two splines. \r\nSplines can be saved and loaded in json format.\r\n\r\nThe [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) class has methods to create individual hyperplanes in any dimension, along with axis-aligned hyperplanes and hypercubes.\r\n\r\nThe [Solid](https://ericbrec.github.io/BSpy/bspy/solid.html) class has methods to construct n-dimensional solids from trimmed [Manifold](https://ericbrec.github.io/BSpy/bspy/manifold.html) boundaries. Each solid consists of a list of boundaries and a Boolean value that indicates if the solid contains infinity. Each [Boundary](https://ericbrec.github.io/BSpy/bspy/solid.html) consists of a manifold (currently a [Hyperplane](https://ericbrec.github.io/BSpy/bspy/hyperplane.html) or [Spline](https://ericbrec.github.io/BSpy/bspy/spline.html)) and a domain solid that trims the manifold. Solids have methods to form the intersection, union, difference, and complement of solids. There are methods to compute point containment, winding numbers, surface integrals, and volume integrals. There are also methods to translate, transform, and slice solids. Solids can be saved and loaded in json format.\r\n\r\nThe [SplineBlock](https://ericbrec.github.io/BSpy/bspy/spline_block.html) class has methods to process an array-like collection of splines that represent a system of equations. There are highly-optimized methods to compute the contours and zeros of a spline block, as well as a variety of methods to manipulate and evaluate a spline block and its derivatives.\r\n\r\nThe [BSpyConvert](https://pypi.org/project/BSpyConvert/) package converts BSpy splines and solid models to and from [OpenCascade (OCCT)](https://dev.opencascade.org/) equivalents and a variety of geometry and CAD file formats, including STEP, IGES, and STL.\r\n\r\nThe [SplineOpenGLFrame](https://ericbrec.github.io/BSpy/bspy/splineOpenGLFrame.html) class is an \r\n[OpenGLFrame](https://pypi.org/project/pyopengltk/) with custom shaders to render spline curves and surfaces. Spline surfaces with more \r\nthan 3 dependent variables will have their added dimensions rendered as colors (up to 6 dependent variables are supported). Only tested on Windows systems.\r\n\r\nThe [Viewer](https://ericbrec.github.io/BSpy/bspy/viewer.html) class is a \r\n[tkinter.Tk](https://docs.python.org/3/library/tkinter.html) app that hosts a \r\n[SplineOpenGLFrame](https://ericbrec.github.io/BSpy/bspy/splineOpenGLFrame.html), \r\na tree view full of solids and splines, and a set of controls to adjust and view the selected solids and splines. Only tested on Windows systems.\r\n\r\nThe [Graphics](https://ericbrec.github.io/BSpy/bspy/viewer.html#Graphics) class is a graphics engine to display splines.\r\nIt launches a [Viewer](https://ericbrec.github.io/BSpy/bspy/viewer.html) and issues commands to the viewer for use \r\nin [jupyter](https://jupyter.org/) notebooks and other scripting environments. Only tested on Windows systems.\r\n\r\n![Viewer rendering the Utah teapot](https://ericbrec.github.io/BSpy/viewer.png \"Viewer rendering the Utah teapot\")\r\n\r\nThe full documentation for BSpy can be found [here](https://ericbrec.github.io/BSpy), its GitHub project can be found \r\n[here](https://github.com/ericbrec/BSpy), a test suite can be found [here](https://github.com/ericbrec/BSpy/tree/main/tests), and\r\na set of examples, including a jupyter notebook, can be found [here](https://github.com/ericbrec/BSpy/tree/main/examples).\r\n\r\n### Release 3.0 breaking changes\r\n* Removed accuracy as a member of Spline\r\n* Spline.common_basis is now a static method (see documentation for details)\r\n* Spline.least_squares changed arguments (see documentation for details)\r\n* Spline.load always returns a list of splines\r\n\r\n### Release 4.0 breaking changes\r\n* Removed Spline blossom method\r\n* Removed DrawableSpline class\r\n* Changed bspyApp class name to Viewer\r\n* Changed Viewer listbox to use extended selection (shift and ctrl keys)\r\n* Changed bspyGraphics class name to Graphics\r\n* Moved DrawableSpine methods for adjusting spline appearance to Viewer (see documentation for details)\r\n* Spline.bspline_values changed arguments (see documentation for details)\r\n* Spline.intersect changed return values (see documentation for details)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library for manipulating and rendering non-uniform B-splines",
"version": "4.3",
"project_urls": {
"Bug Tracker": "http://github.com/ericbrec/BSpy/issues",
"Homepage": "http://github.com/ericbrec/BSpy"
},
"split_keywords": [
"bspline",
" b-spline",
" nub",
" solid",
" solid modeling",
" geometry",
" csg",
" opengl",
" tkinter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "24c0aa4398a1086468790b62214fafea2f35588cd05eb10840e178c173bd888e",
"md5": "1adba8ab4e9a83db24731d38a8c766e7",
"sha256": "6c1548175dceca2d3aad673827ca6a89cea5a60fe5b3e09e22324de9341bdd3e"
},
"downloads": -1,
"filename": "bspy-4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1adba8ab4e9a83db24731d38a8c766e7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.0",
"size": 117625,
"upload_time": "2024-12-14T15:49:13",
"upload_time_iso_8601": "2024-12-14T15:49:13.292696Z",
"url": "https://files.pythonhosted.org/packages/24/c0/aa4398a1086468790b62214fafea2f35588cd05eb10840e178c173bd888e/bspy-4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bea77cbac7edabd6145342fd460f21b02f2082b97c65525eed76d6818512d27a",
"md5": "76a1a227fd962207a9bfaeaa752e8b2a",
"sha256": "a3da61aead0c89d79eb01056c4faf7410391eb3cf2d6b6865fcce2f25415ebcc"
},
"downloads": -1,
"filename": "bspy-4.3.tar.gz",
"has_sig": false,
"md5_digest": "76a1a227fd962207a9bfaeaa752e8b2a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.0",
"size": 112085,
"upload_time": "2024-12-14T15:49:15",
"upload_time_iso_8601": "2024-12-14T15:49:15.827600Z",
"url": "https://files.pythonhosted.org/packages/be/a7/7cbac7edabd6145342fd460f21b02f2082b97c65525eed76d6818512d27a/bspy-4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-14 15:49:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ericbrec",
"github_project": "BSpy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "bspy"
}
JSON
