mbcp.mp_math.point
Description: 本模块定义了三维空间中点的类。
class Point3
def __init__(self, x: float, y: float, z: float)
Description: 笛卡尔坐标系中的点。
Arguments:
- x (
float
): x 坐标- y (
float
): y 坐标- z (
float
): z 坐标
Source code or View on GitHub
python
def __init__(self, x: float, y: float, z: float):
"""
笛卡尔坐标系中的点。
Args:
x ([`float`](https://docs.python.org/3/library/functions.html#float)): x 坐标
y (`float`): y 坐标
z (`float`): z 坐标
"""
self.x = x
self.y = y
self.z = z
def approx(self, other: Point3, epsilon: float = APPROX) -> bool
Description: 判断两个点是否近似相等。
Arguments:
Return: bool
: 是否近似相等
Source code or View on GitHub
python
def approx(self, other: 'Point3', epsilon: float=APPROX) -> bool:
"""
判断两个点是否近似相等。
Args:
other ([`Point3`](./point#class-point3)): 另一个点
epsilon ([`float`](https://docs.python.org/3/library/functions.html#float)): 误差
Returns:
[`bool`](https://docs.python.org/3/library/functions.html#bool): 是否近似相等
"""
return all([abs(self.x - other.x) < epsilon, abs(self.y - other.y) < epsilon, abs(self.z - other.z) < epsilon])
@overload
def self + other: Vector3 => Point3
Source code or View on GitHub
python
@overload
def __add__(self, other: 'Vector3') -> 'Point3':
...
@overload
def self + other: Point3 => Point3
Source code or View on GitHub
python
@overload
def __add__(self, other: 'Point3') -> 'Point3':
...
def self + other
Description: P + V -> P P + P -> P
Arguments:
Return: Point3
: 新的点
Source code or View on GitHub
python
def __add__(self, other):
"""
P + V -> P
P + P -> P
Args:
other ([`Vector3`](./vector#class-vector3) | [`Point3`](./point#class-point3)): 另一个点或向量
Returns:
[`Point3`](./point#class-point3): 新的点
"""
return Point3(self.x + other.x, self.y + other.y, self.z + other.z)
def __eq__(self, other)
Description: 判断两个点是否相等。
Arguments:
- other (
Point3
): 另一个点
Return: bool
: 是否相等
Source code or View on GitHub
python
def __eq__(self, other):
"""
判断两个点是否相等。
Args:
other ([`Point3`](./point#class-point3)): 另一个点
Returns:
[`bool`](https://docs.python.org/3/library/functions.html#bool): 是否相等
"""
return approx(self.x, other.x) and approx(self.y, other.y) and approx(self.z, other.z)
def self - other: Point3 => Vector3
Description: P - P -> V
P - V -> P 已在 Vector3
中实现
Arguments:
- other (
Point3
): 另一个点
Return: Vector3
: 新的向量
Source code or View on GitHub
python
def __sub__(self, other: 'Point3') -> 'Vector3':
"""
P - P -> V
P - V -> P 已在 [`Vector3`](./vector#class-vector3) 中实现
Args:
other ([`Point3`](./point#class-point3)): 另一个点
Returns:
[`Vector3`](./vector#class-vector3): 新的向量
"""
from .vector import Vector3
return Vector3(self.x - other.x, self.y - other.y, self.z - other.z)