absfuyu.general.shape module

Absfuyu: Shape

Shapes

Version: 5.1.0 Date updated: 10/03/2025 (dd/mm/yyyy)

class absfuyu.general.shape.Triangle(a: int | float, b: int | float, c: int | float)

Bases: Polygon

perimeter() → int | float

Calculates and returns the perimeter of the triangle.

area() → int | float

Calculates and returns the area of the triangle using Heron’s formula.

is_right_angled() → bool

Checks if the triangle is a right-angled triangle (one vertex has degree of 90) using the Pythagorean theorem.

Returns:

True if the triangle is right-angled, False otherwise.

Return type:

bool

is_equilateral() → bool

Checks if the triangle is an equilateral triangle (3 sides have the same length).

Returns:

True if the triangle is equilateral, False otherwise.

Return type:

bool

is_isosceles() → bool

Checks if the triangle is an isosceles triangle (at least two sides are equal).

Returns:

True if the triangle is isosceles, False otherwise.

Return type:

bool

triangle_type() → str

Determines the type of triangle based on its sides.

Returns:

A string describing the type of triangle: "equilateral", "isosceles", "right-angled", or "scalene" if none of the other types apply.

Return type:

str

is_acute() → bool

Checks if the triangle is an acute triangle (all angles less than 90 degrees).

Returns:

True if the triangle is acute, False otherwise.

Return type:

bool

is_obtuse() → bool

Checks if the triangle is an obtuse triangle (one angle greater than 90 degrees).

Returns:

True if the triangle is obtuse, False otherwise.

Return type:

bool

get_angles() → tuple[float, float, float]

Calculates and returns the angles of the triangle in degrees.

Returns:

A tuple containing the angles in degrees (angle_A, angle_B, angle_C).

Return type:

tuple[float, float, float]

scale(factor: int | float) → None

Scales the triangle by a given factor, changing the lengths of all sides.

Parameters:

factor (int | float) – The scaling factor. Must be positive.

Raises:

ValueError – If the scaling factor is not positive.

is_similar(other: Self) → bool

Checks if this triangle is similar to another triangle.

Parameters:

other (Triangle) – The other triangle to compare to.

Returns:

True if the triangles are similar, False otherwise.

Return type:

bool

vis() → str

Visualization of Triangle

class absfuyu.general.shape.Circle(radius: int | float)

Bases: Polygon

diameter() → int | float

Returns the diameter of the circle.

perimeter() → float

Returns the circumference of the circle.

circumference() → float

Returns the circumference of the circle.

area() → float

Returns the area of the circle.

scale(factor: int | float) → None

Scales the circle by a given factor, changing its radius.

Parameters:

factor (int | float) – The scaling factor. Must be positive.

Raises:

ValueError – If the scaling factor is not positive.

classmethod from_area(area: int | float) → Self

Creates a Circle instance from its area.

Parameters:

area (int | float) – The area of the circle. Must be positive.

Raises:

ValueError – If the area is not positive.

classmethod from_circumference(circumference: int | float) → Self

Creates a Circle instance from its circumference.

Parameters:

circumference (int | float) – The circumference of the circle. Must be positive.

Raises:

ValueError – If the circumference is not positive.

class absfuyu.general.shape.Square(side: int | float)

Bases: EqualSidesPolygon

area() → int | float

Calculate the area of the square.

diagonal() → float

Calculate the length of the diagonal of the square.

classmethod from_perimeter(perimeter: int | float) → Self

Create a Square instance from its perimeter.

classmethod from_area(area: int | float) → Self

Create a Square instance from its area.

scale(factor: int | float) → None

Scales the square by a given factor.

Parameters:

factor (int | float) – The scaling factor. Must be positive.

Raises:

ValueError – If the scaling factor is not positive.

class absfuyu.general.shape.Rectangle(length: int | float, width: int | float)

Bases: Polygon

perimeter() → int | float

Calculates and returns the perimeter of the rectangle.

area() → int | float

Calculates and returns the area of the rectangle.

diagonal() → float

Calculates and returns the length of the diagonal of the rectangle.

is_square() → bool

Checks if the rectangle is a square (length equals width).

scale(factor: int | float) → None

Scales the rectangle by a given factor.

Parameters:

factor (int | float) – The scaling factor. Must be positive.

Raises:

ValueError – If the scaling factor is not positive.

class absfuyu.general.shape.Pentagon(side: int | float)

Bases: EqualSidesPolygon

area() → float

Calculates and returns the area of the pentagon using a specific formula.

apothem() → float

Calculates and returns the apothem of the pentagon.

area2() → float

Calculates the area using the apothem and perimeter.

classmethod from_area(area: int | float) → Self

Creates a Pentagon instance from its area.

Parameters:

area (int | float) – The area of the pentagon. Must be positive.

Raises:

ValueError – If the area is not positive.

classmethod from_perimeter(perimeter: int | float) → Self

Creates a Pentagon instance from its perimeter.

Parameters:

perimeter (int | float) – The perimeter of the pentagon. Must be positive.

Raises:

ValueError – If the perimeter is not positive.

class absfuyu.general.shape.Hexagon(side: int | float)

Bases: EqualSidesPolygon

area() → float

Calculates and returns the area of the hexagon.

apothem() → float

Calculates and returns the apothem of the hexagon.

area2() → float

Calculates the area using the apothem and perimeter.

classmethod from_area(area: int | float) → Self

Creates a Hexagon instance from its area.

Parameters:

area (int | float) – The area of the hexagon. Must be positive.

Raises:

ValueError – If the area is not positive.

classmethod from_perimeter(perimeter: int | float) → Self

Creates a Hexagon instance from its perimeter.

Parameters:

perimeter (int | float) – The perimeter of the hexagon. Must be positive.

Raises:

ValueError – If the perimeter is not positive.

class absfuyu.general.shape.Parallelogram(base: int | float, height: int | float, *, a: int | float | None = None, phi: int | float | None = None)

Bases: Polygon

perimeter() → int | float

Calculates and returns the perimeter of the parallelogram.

Raises:

ValueError – If neither side a nor angle phi is provided.

area() → int | float

Calculates and returns the area of the parallelogram.

class absfuyu.general.shape.Rhombus(d1: int | float, d2: int | float)

Bases: Polygon

perimeter() → float

Calculates and returns the perimeter of the rhombus.

area() → float

Calculates and returns the area of the rhombus.

side() → float

Calculates and returns the length of one side of the rhombus.

class absfuyu.general.shape.Trapezoid(a: int | float, b: int | float, c: int | float | None = None, d: int | float | None = None, h: int | float | None = None)

Bases: Polygon

perimeter() → int | float

Calculates and returns the perimeter of the trapezoid.

area() → float

Calculates and returns the area of the trapezoid.

class absfuyu.general.shape.Cube(side: int | float)

Bases: ThreeDimensionShape

surface_area() → int | float

Calculates and returns the surface area of the cube.

surface_area_side() → int | float

Calculates and returns the surface area (side only) of the cube.

volume() → int | float

Calculates and returns the volume of the cube.

face_area() → int | float

Calculates and returns the area of one face of the cube.

diagonal() → float

Calculates and returns the length of the space diagonal of the cube.

scale(factor: int | float) → None

Scales the cube by a given factor.

classmethod from_surface_area(surface_area: int | float) → Self

Creates a Cube instance from its surface area.

Parameters:

surface_area (int | float) – The surface area of the cube. Must be positive.

Raises:

ValueError – If surface area is not positive.

classmethod from_volume(volume: int | float) → Self

Creates a Cube instance from its volume.

Parameters:

volume (int | float) – The volume of the cube. Must be positive.

Raises:

ValueError – If volume is not positive.

class absfuyu.general.shape.Cuboid(length: int | float, width: int | float, height: int | float)

Bases: ThreeDimensionShape

surface_area() → int | float

Calculates and returns the surface area of the cuboid.

surface_area_side() → int | float

Calculates and returns the surface area of the sides of the cuboid.

volume() → int | float

Calculates and returns the volume of the cuboid.

diagonal() → float

Calculates and returns the length of the space diagonal of the cuboid.

scale(factor: int | float) → None

Scales the dimensions of the cuboid by a given factor.

class absfuyu.general.shape.Sphere(radius: int | float)

Bases: ThreeDimensionShape

surface_area() → float

Calculates and returns the surface area of the sphere.

volume() → float

Calculates and returns the volume of the sphere.

classmethod from_volume(volume: int | float) → Self

Creates a Sphere instance from its volume.

Parameters:

volume (int | float) – The volume of the sphere. Must be positive.

Raises:

ValueError – If volume is not positive.

classmethod from_surface_area(surface_area: int | float) → Self

Creates a Sphere instance from its surface area.

Parameters:

surface_area (int | float) – The surface area of the sphere. Must be positive.

Raises:

ValueError – If surface area is not positive.

class absfuyu.general.shape.HemiSphere(radius: int | float)

Bases: ThreeDimensionShape

surface_area() → float

Calculates and returns the total surface area of the hemisphere.

surface_area_curved() → float

Calculates and returns the curved surface area of the hemisphere.

surface_area_base() → float

Calculates and returns the area of the base (circular) of the hemisphere.

volume() → float

Calculates and returns the volume of the hemisphere.

classmethod from_volume(volume: int | float) → Self

Creates a HemiSphere instance from its volume.

Parameters:

volume (int | float) – The volume of the hemisphere. Must be positive.

Raises:

ValueError – If the volume is not positive.

classmethod from_surface_area(surface_area: int | float) → Self

Creates a HemiSphere instance from its total surface area.

Parameters:

surface_area (int | float) – The total surface area of the hemisphere. Must be positive.

Raises:

ValueError – If the surface area is not positive.

class absfuyu.general.shape.Cylinder(radius: int | float, height: int | float)

Bases: ThreeDimensionShape

surface_area() → float

Calculates and returns the total surface area of the cylinder.

surface_area_curved() → float

Calculates and returns the curved surface area of the cylinder.

volume() → float

Calculates and returns the volume of the cylinder.