eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width module

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.compensation_length_at_transition_zone(distance_belt_edge_to_deepest_level_of_trough: Quantity, pulley_lift: Quantity, maximal_allowed_pulley_lift: Quantity, unit: str = 'meter', precision: int = 2) → Quantity

Calculates the compensation length at the transition zone of a conveyor belt. This function computes the compensation length based on the distance from the belt edge to the deepest level of the trough, the pulley lift, and the maximal allowed pulley lift. The result is returned in the specified unit with an optional precision. :param distance_belt_edge_to_deepest_level_of_trough: The distance from the belt edge to the deepest level of the trough. :type distance_belt_edge_to_deepest_level_of_trough: Quantity :param pulley_lift: The lift of the pulley. :type pulley_lift: Quantity :param maximal_allowed_pulley_lift: The maximum allowed lift of the pulley. :type maximal_allowed_pulley_lift: Quantity :param unit: The unit in which the result should be returned. Defaults to “meter”. :type unit: str, optional :param precision: The number of decimal places to round the result to. Defaults to 2. :type precision: int, optional

Returns:

The compensation length at the transition zone in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting input values or if the unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.difference_edge_and_center_belt_tensions_steel_cord_belts(length_of_belt_edge_in_transition_zone: Quantity, minimal_transition_length: Quantity, reference_length_of_transition_zone_for_steel_cord_belts: Quantity, elastic_modulus: Quantity, unit: str = 'newton / millimeter', precision: int = 2) → Quantity

Calculate the difference between edge and center belt tensions for steel cord belts. This function computes the difference in tensions between the edge and center of a steel cord belt based on the provided parameters. The calculation considers the length of the belt edge in the transition zone, the minimal transition length, a reference length for steel cord belts, and the elastic modulus of the belt material. :param length_of_belt_edge_in_transition_zone: The length of the belt edge in the transition zone,

specified as a Pint Quantity.

Parameters:

• minimal_transition_length (Quantity) – The minimal transition length, specified as a Pint Quantity.

• reference_length_of_transition_zone_for_steel_cord_belts (Quantity) – The reference length of the transition zone for steel cord belts, specified as a Pint Quantity.

• elastic_modulus (Quantity) – The elastic modulus of the belt material, specified as a Pint Quantity.

• unit (str, optional) – The desired output unit for the result. Defaults to “newton / milimeter”.

• precision (int, optional) – The number of decimal places to round the result to. Defaults to 6.

Returns:

The difference between edge and center belt tensions, expressed as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

• ValueError – If there is an error in converting input values to the required units or if the

• specified unit is invalid. –

Notes

• The function internally uses a helper function _difference_edge_and_center_belt_tensions_steel_cord_belts to perform the core calculation.

• The input quantities must be compatible with the expected units for proper conversion and calculation.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.difference_edge_and_center_belt_tensions_textile_belts(length_of_belt_edge_in_transition_zone: Quantity, minimal_transition_length: Quantity, elastic_modulus: Quantity, unit: str = 'newton / millimeter', precision: int = 2) → Quantity

Calculate the difference between edge and center belt tensions for steel cord belts. This function computes the difference in tensions between the edge and center of a steel cord belt based on the provided parameters. The calculation considers the length of the belt edge in the transition zone, the minimal transition length, a reference length for steel cord belts, and the elastic modulus of the belt material. :param length_of_belt_edge_in_transition_zone: The length of the belt edge in the transition zone,

specified as a Pint Quantity.

Parameters:

• minimal_transition_length (Quantity) – The minimal transition length, specified as a Pint Quantity.

• elastic_modulus (Quantity) – The elastic modulus of the belt material, specified as a Pint Quantity.

• unit (str, optional) – The desired output unit for the result. Defaults to “newton / milimeter”.

• precision (int, optional) – The number of decimal places to round the result to. Defaults to 6.

Returns:

The difference between edge and center belt tensions, expressed as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

• ValueError – If there is an error in converting input values to the required units or if the

• specified unit is invalid. –

Notes

• The function internally uses a helper function _difference_edge_and_center_belt_tensions_steel_cord_belts to perform the core calculation.

• The input quantities must be compatible with the expected units for proper conversion and calculation.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.distance_belt_edge_to_pulley_surface_level(distance_belt_edge_to_deepest_level_of_trough: Quantity, pulley_lift: Quantity, unit: str = 'millimeter', precision: int = 2) → Quantity

Calculates the distance from the belt edge to the pulley surface level. This function computes the distance from the edge of a belt to the surface level of a pulley, taking into account the distance to the deepest level of the trough and the pulley lift. The result is returned in the specified unit with the desired precision. :param distance_belt_edge_to_deepest_level_of_trough: The distance from the belt edge to the deepest level of the trough,

expressed as a Pint Quantity.

Parameters:

• pulley_lift (Quantity) – The lift of the pulley, expressed as a Pint Quantity.

• unit (str, optional) – The unit in which the result should be returned. Defaults to “millimeter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The calculated distance from the belt edge to the pulley surface level, expressed as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting the input values to the desired unit or if the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.length_of_belt_edge_in_transition_zone(minimal_transition_length: Quantity, pulley_lift: Quantity, part_of_belt_lying_on_side_idler: Quantity, troughing_angle: Quantity, unit: str = 'meter', precision: int = 6) → Quantity

Calculate the length of the belt edge in the transition zone. This function computes the length of the belt edge in the transition zone based on the minimal transition length, pulley lift, part of the belt lying on the side idler, and the troughing angle. The result can be returned in a specified unit with a given precision. :param minimal_transition_length: The minimal transition length,

provided as a Pint Quantity.

Parameters:

• pulley_lift (Quantity) – The vertical lift of the pulley, provided as a Pint Quantity.

• part_of_belt_lying_on_side_idler (Quantity) – The portion of the belt lying on the side idler, provided as a Pint Quantity.

• troughing_angle (Quantity) – The troughing angle, provided as a Pint Quantity.

• unit (str, optional) – The desired unit for the result. Defaults to “meter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The length of the belt edge in the transition zone, as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting input values to the required units or if the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.local_belt_force_related_to_belt_width(mean_belt_tension: Quantity, belt_width: Quantity, unit: str = 'kilonewton', precision: int = 2) → Quantity

Calculate the local belt force related to the belt width.

Parameters:

• mean_belt_tension (Quantity) – The mean belt tension value with units.

• belt_width (Quantity) – The width of the belt with units.

• unit (str, optional) – The unit for the output local belt force (default is “kilonewton”).

• precision (int, optional) – The precision for rounding the result (default is 2).

Returns:

The local belt force related to the belt width in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting values or if the unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.local_center_belt_force(mean_belt_tension_related_to_belt_width: Quantity, part_of_belt_lying_on_side_idler: Quantity, belt_width: Quantity, difference_edge_and_center_belt_tensions: Quantity, unit: str = 'newton / millimeter', precision: int = 2) → Quantity

Calculate the center belt force based on various parameters. This function computes the center belt force using the mean belt tension related to the belt width, the portion of the belt lying on the side idler, the belt width, and the difference between edge and center belt tensions. The result is returned in the specified unit with optional precision. :param mean_belt_tension_related_to_belt_width: The mean belt tension per unit width of the belt, expressed as a

Pint Quantity.

Parameters:

• part_of_belt_lying_on_side_idler (Quantity) – The portion of the belt lying on the side idler, expressed as a Pint Quantity.

• belt_width (Quantity) – The total width of the belt, expressed as a Pint Quantity.

• difference_edge_and_center_belt_tensions (Quantity) – The difference between the edge and center belt tensions, expressed as a Pint Quantity.

• unit (str, optional) – The desired unit for the output force. Defaults to “kilonewton”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The calculated center belt force as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting input values to the required units or if the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.local_edge_belt_force(local_center_belt_force: Quantity, difference_edge_and_center_belt_tensions: Quantity, unit: str = 'newton / millimeter', precision: int = 2) → Quantity

Calculate the local edge belt force based on the local center belt force and the difference between edge and center belt tensions. :param local_center_belt_force: The local center belt force,

expected to be a Pint Quantity with units convertible to “newton / millimeter”.

Parameters:

• difference_edge_and_center_belt_tensions (Quantity) – The difference between edge and center belt tensions, expected to be a Pint Quantity with units convertible to “newton / millimeter”.

• unit (str, optional) – The desired output unit for the result. Defaults to “newton / millimeter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The calculated local edge belt force as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

• ValueError – If the input quantities cannot be converted to “newton / millimeter”.

• ValueError – If the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.maximal_allowable_pulley_lift(distance_from_edge_to_deepest_trough_level: Quantity, unit: str = 'millimeter', precision: int = 2) → Quantity

Calculate the maximal allowable pulley lift based on the distance from the edge to the deepest trough level. :param distance_from_edge_to_deepest_trough_level: The distance from the edge to the deepest trough level, provided as a

Pint Quantity object.

Parameters:

• unit (str, optional) – The desired output unit for the result. Defaults to “millimeter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The maximal allowable pulley lift as a Pint Quantity object, converted to the specified unit.

Return type:

Quantity

Raises:

• ValueError – If the input distance cannot be converted to meters or if the

• specified unit is invalid. –

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.mean_belt_tension_related_to_belt_width(local_belt_force: Quantity, belt_width: Quantity, unit: str = 'newton / millimeter', precision: int = 2) → Quantity

Calculate the mean belt tension related to the belt width.

Parameters:

• local_belt_force (Quantity) – The local belt force value with units.

• belt_width (Quantity) – The width of the belt with units.

• unit (str, optional) – The unit for the output mean belt tension (default is “newton / millimeter”).

• precision (int, optional) – The precision for rounding the result (default is 2).

Returns:

The mean belt tension related to the belt width in the specified unit.

Return type:

Quantity

Raises:

ValueError – If there is an error in converting local belt force or if the unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.minimal_transition_length(coefficient_minimum_transition_length: CoefficientMinimumTransitionLength, distance_belt_edge_pulley_surface_level: Quantity, unit: str = 'meter', precision: int = 2) → Quantity

Calculate the minimal transition length for a belt system. This function computes the minimal transition length required for a belt system based on the coefficient of minimum transition length and the distance between the belt edge and the pulley surface level. :param coefficient_minimum_transition_length: The coefficient used to calculate the minimal transition length. :type coefficient_minimum_transition_length: CoefficientMinimumTransitionLength :param distance_belt_edge_pulley_surface_level: The distance between the belt edge and the pulley surface level,

provided as a Pint Quantity.

Parameters:

• unit (str, optional) – The desired unit for the result. Defaults to “meter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The minimal transition length as a Pint Quantity in the specified unit.

Return type:

Quantity

Raises:

ValueError – If the input distance cannot be converted to meters or if the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.part_of_belt_lying_on_side_idler(belt_width: Quantity, length_center_roller: Quantity, unit: str = 'millimeter', precision: int = 2) → Quantity

Calculate the part of the belt lying on the side idler based on the belt width and the length of the center roller.

For flat trough configurations where the center roller length equals or exceeds the belt width, returns 0 as there are no side idlers.

Parameters:

• belt_width (Quantity) – The width of the belt as a Pint Quantity.

• length_center_roller (Quantity) – The length of the center roller as a Pint Quantity.

• unit (str, optional) – The desired unit for the result. Defaults to “millimeter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The calculated part of the belt lying on the side idler in the specified unit.

Returns 0 for flat trough configurations (length_center_roller >= belt_width).

Return type:

Quantity

Raises:

• ValueError – If there is an error in converting the input values to meters.

• ValueError – If belt_width is zero or negative.

• ValueError – If length_center_roller is negative.

• ValueError – If the specified unit is invalid.

eytelwein.belt_conveyor_design.core.distribution_of_belt_tensions_across_belt_width.reference_length_of_transition_zone_for_steel_cord_belts(minimal_transition_length: Quantity, compensation_length: Quantity, unit: str = 'meter', precision: int = 2) → Quantity

Calculate the reference length of the transition zone for steel cord belts. This function computes the reference length of the transition zone based on the minimal transition length and the compensation length. The result is returned in the specified unit with an optional precision. :param minimal_transition_length: The minimal transition length,

provided as a Pint Quantity object.

Parameters:

• compensation_length (Quantity) – The compensation length, provided as a Pint Quantity object.

• unit (str, optional) – The unit in which the result should be returned. Defaults to “meter”.

• precision (int, optional) – The number of decimal places to round the result to. If None, no rounding is applied. Defaults to 2.

Returns:

The reference length of the transition zone as a Pint Quantity object in the specified unit.

Return type:

Quantity

Raises:

ValueError – If the input values cannot be converted to meters or if the specified unit is invalid.