aerocaps.geom.curves.PCurve3D#

class PCurve3D(name: str, construction: bool = False)[source]#

Three-dimensional abstract parametric curve class

__init__(name: str, construction: bool = False)#

Abstract geometry class

Parameters:

name (str) – Name of the geometric object. May be re-assigned a unique name when added to a GeometryContainer
construction (bool) – Whether this is a geometry used only for construction of other geometries. If True, this geometry will not be exported or plotted. Default: False

Methods

`d2cdt2`(t)	Evaluates the second derivative of the curve with respect to \(t\)
`dcdt`(t)	Evaluates the first derivative of the curve with respect to \(t\)
`evaluate`(t)	Evaluates the line at one or more \(t\)-values
`evaluate_pcurvedata`(t)	Evaluates a verbose set of parametric curve data as a class based on an input parameter value or vector
`evaluate_point3d`(t)	Evaluates the line at one or more \(t\)-values and returns a single point object or list of point objects
`transform`(**transformation_kwargs)	Creates a transformed copy of the curve by transforming the control points

Attributes

abstractmethod d2cdt2(t: float) → float[source]#

Evaluates the second derivative of the curve with respect to \(t\)

Parameters:: t (float or int or numpy.ndarray) – Either a single \(t\)-value, a number of evenly spaced \(t\)-values between 0 and 1, or a 1-D array of \(t\)-values
Returns:: If \(t\) is a float, the output is a 1-D array containing three elements: the \(x\)- \(y\)-, and \(z\)-components of the second derivative. Otherwise, the output is a 2-D array of size \(\text{len}(t) \times 3\)
Return type:: numpy.ndarray

abstractmethod dcdt(t: float) → float[source]#

Evaluates the first derivative of the curve with respect to \(t\)

Parameters:: t (float or int or numpy.ndarray) – Either a single \(t\)-value, a number of evenly spaced \(t\)-values between 0 and 1, or a 1-D array of \(t\)-values
Returns:: If \(t\) is a float, the output is a 1-D array containing two elements: the \(x\)- \(y\), and \(z\)-components of the first derivative. Otherwise, the output is a 2-D array of size \(\text{len}(t) \times 3\)
Return type:: numpy.ndarray

abstractmethod evaluate(t: float) → float[source]#

Evaluates the line at one or more \(t\)-values

Parameters:: t (float or int or numpy.ndarray) – Either a single \(t\)-value, a number of evenly spaced \(t\)-values between 0 and 1, or a 1-D array of \(t\)-values
Returns:: If t is a float, the output is a 1-D array with three elements: the values of \(x\), \(y\), and \(x\). Otherwise, the output is an array of size \(\text{len}(t) \times 3\)
Return type:: numpy.ndarray

abstractmethod evaluate_pcurvedata(t: float) → PCurveData3D[source]#

Evaluates a verbose set of parametric curve data as a class based on an input parameter value or vector

Parameters:: t (float or int or numpy.ndarray) – Either a single \(t\)-value, a number of evenly spaced \(t\)-values between 0 and 1, or a 1-D array of \(t\)-values
Returns:: Parametric curve information, including derivative and curvature data
Return type:: PCurveData3D

abstractmethod evaluate_point3d(t: float) → Point3D[source]#

Evaluates the line at one or more \(t\)-values and returns a single point object or list of point objects

Parameters:: t (float or int or numpy.ndarray) – Either a single \(t\)-value, a number of evenly spaced \(t\)-values between 0 and 1, or a 1-D array of \(t\)-values
Returns:: If t is a float, the output is a single point object. Otherwise, the output is a list of point objects
Return type:: Point3D or List[Point3D]

abstractmethod transform(**transformation_kwargs) → PCurve3D[source]#

Creates a transformed copy of the curve by transforming the control points

Parameters:: transformation_kwargs – Keyword arguments passed to Transformation3D
Returns:: Transformed curve
Return type:: PCurve3D