Struct RectangularWire 

pub struct RectangularWire { /* private fields */ }

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

This type of wire is often found in “constructed” windings such as hairpin windings with a low number of turns per coil. It is defined by the following fields:

• height: Height of the bar. Must be positive.
• width: Width of the bar. Must be positive.
• insulation_thickness: Thickness of the insulation layer wrapped around the outer diameter. Must be positive or zero (zero means 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), // height
    Length::new::<millimeter>(1.0), // width
    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 RectangularWire

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

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

• height must be positive.
• width must be positive.
• insulation_thickness must be positive or zero.

See the struct docstring RectangularWire for more.

Examples

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

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

// Height is not positive
assert!(RectangularWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(0.0),
    Length::new::<millimeter>(1.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Width is not positive
assert!(RectangularWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(-1.0),
    Length::new::<millimeter>(0.1)
).is_err());

// Insulation thickness is negative
assert!(RectangularWire::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_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 RectangularWire struct.

Examples

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

let wire = RectangularWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(1.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 RectangularWire struct.

Examples

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

let wire = RectangularWire::new(
    Arc::new(Material::default()),
    Length::new::<millimeter>(2.0),
    Length::new::<millimeter>(1.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 RectangularWire

fn clone(&self) -> RectangularWire

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RectangularWire

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

Formats the value using the given formatter.

impl Default for RectangularWire

fn default() -> RectangularWire

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RectangularWire

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 RectangularWire

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 RectangularWire

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.