Struct RoundWire 

pub struct RoundWire { /* private fields */ }

A flexible, round bar made of a conducting material, usually a metal such as copper, possibly with an insulation layer.

This is the “classic” round wire used in the vast majority of electrical machines. It is defined by the following fields:

• outer_diameter: Outer diameter of the conductor. Must be positive (outer_diameter > 0 m).
• inner_diameter: Inner diameter of the conductor. Must be positive or zero, but smaller than outer_diameter (outer_diameter > inner_diameter >= 0 m). A positive value means the conductor is hollow, e.g. to form a channel for cooling fluids.
• insulation_thickness: Thickness of the insulation layer wrapped around the outer diameter. Must be positive or zero (insulation_thickness >= 0 m), with zero equals no insulation layer.
• conductor_material: The material of the conductor.

The effective conductor area is the space between the inner and the outer diameter:

use std::sync::Arc;
use std::f64::consts::PI;

use approx::assert_abs_diff_eq;

use stem_wire::prelude::*;

let wire_round = RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0), // outer_diameter
    Length::new::<millimeter>(1.0), // inner_diameter
    Length::new::<millimeter>(0.1), // insulation_thickness
).expect("valid inputs");

assert_abs_diff_eq!(
    wire_round.effective_conductor_area(Area::new::<square_millimeter>(20.0), 3).get::<square_millimeter>(),
    PI - 0.25*PI,
    epsilon = 1e-3
);

Deserialization

All length fields accept SI units during deserialization (e.g. 8 mm, 0.5 m). See crate-level and dyn_quantity documentation for details.

Implementations

impl RoundWire

pub fn new( conductor_material: Arc<Material>, outer_diameter: Length, inner_diameter: Length, insulation_thickness: Length, ) -> Result<Self, Error>

Returns a new instance of RoundWire if the given field values fulfill the following conditions:

• outer_diameter must be positive (outer_diameter > 0 m).
• inner_diameter must be positive or zero (inner_diameter >= 0 m).
• insulation_thickness must be positive or zero (insulation_thickness >= 0 m).

See the struct docstring RoundWire for more.

Examples

use std::sync::Arc;
use stem_wire::prelude::*;

assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(1.0),
    Length::new::<millimeter>(0.1)
).is_ok());

// Outer diameter negative
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(-2.0),
    Length::new::<millimeter>(1.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Outer diameter zero
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(1.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Inner diameter larger than outer diameter
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(2.2),
    Length::new::<millimeter>(0.1)
).is_err());

// Inner diameter equals outer diameter
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Inner diameter negative
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(-1.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Insulation negative
assert!(RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(1.0),
    Length::new::<millimeter>(-0.1)
).is_err());

pub fn insulation_diameter(&self) -> Length

Returns the “insulation” diameter of the wire (outer diameter plus two times insulation layer)

Examples

use std::sync::Arc;
use stem_wire::prelude::*;

let wire = RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(0.1)
).expect("valid inputs");
assert_eq!(wire.insulation_diameter().get::<millimeter>(), 2.2);

pub fn outer_diameter(&self) -> Length

Returns the outer diameter of the conductor.

pub fn inner_diameter(&self) -> Length

Returns the inner diameter of the conductor.

pub fn insulation_thickness(&self) -> Length

Returns the thickness of the insulation layer.

pub fn conductor_area(&self) -> Area

Returns the conductor area of the wire.

This function returns the same value as Wire::effective_conductor_area, but does not require zone_area and turns due to all needed information being stored within the RoundWire struct.

Examples

use std::sync::Arc;
use stem_wire::prelude::*;

let wire = RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(0.1)
).expect("valid inputs");
assert_eq!(
    wire.conductor_area(),
    wire.effective_conductor_area(Default::default(), 0)
);

pub fn overall_area(&self) -> Area

Returns the overall area of the wire.

This function returns the same value as Wire::effective_overall_area, but does not require zone_area and turns due to all needed information being stored within the RoundWire struct.

Examples

use std::sync::Arc;
use stem_wire::prelude::*;

let wire = RoundWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(0.1)
).expect("valid inputs");
assert_eq!(
    wire.overall_area(),
    wire.effective_overall_area(Default::default(), 0)
);

Trait Implementations

impl Clone for RoundWire

fn clone(&self) -> RoundWire

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RoundWire

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RoundWire

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RoundWire

Available on crate feature serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RoundWire

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Wire for RoundWire

fn material(&self) -> &Material

Returns a shared reference to the conductor material of the wire.

fn material_arc(&self) -> Arc<Material>

Returns the conductor material as a reference-counted Arc.

fn effective_conductor_area(&self, _zone_area: Area, _turns: usize) -> Area

Returns the current-carrying cross section of the wire.

fn effective_overall_area(&self, _zone_area: Area, _turns: usize) -> Area

Returns the overall area covered by the wire.

fn resistance( &self, length: Length, zone_area: Area, turns: usize, conditions: &[DynQuantity<f64>], ) -> ElectricalResistance

Returns the resistance of a wire with the given length under influence of the specified conditions.

fn slot_fill_factor_conductor(&self, zone_area: Area, turns: usize) -> f64

Returns the electrical slot filling factor.

fn slot_fill_factor_overall(&self, zone_area: Area, turns: usize) -> f64

Returns the mechanical slot filling factor.