Struct StrandedWire 

pub struct StrandedWire(/* private fields */);

A stranded wire consistings of multiple WireGroups.

A stranded wire is composed of a number of small wires bundled or wrapped together to form a larger conductor. Compared to a single solid wire, this configuration is more mechanically flexible and allows the usage of a few standardized wires to realize various different cross-sections.

To simplify the implementation, each wire within the given WireGroups must have the same material. In practice, this is not a huge issue, as conductors of different materials are usually not used together in a stranded wire.

Example

A stranded wire consisting of three wires of type A and two wires of type B can be represented as:

• WireGroup { wire: A, number_wires: 3 }
• WireGroup { wire: B, number_wires: 2 }

These groups together form a StrandedWire:

use std::sync::Arc;
use std::num::NonZero;

use stem_wire::prelude::*;

let wire_a = RoundWire::new(
        Arc::new(Material::default()),
        Length::new::<millimeter>(0.5),
        Length::new::<millimeter>(0.0),
        Length::new::<millimeter>(0.1)
    ).unwrap();
let wire_b = RoundWire::new(
        Arc::new(Material::default()),
        Length::new::<millimeter>(0.4),
        Length::new::<millimeter>(0.0),
        Length::new::<millimeter>(0.1)
    ).unwrap();

// Returns OK because the vector of wires was not empty
assert!(StrandedWire::new(vec![
    WireGroup::new(Box::new(wire_a), NonZero::new(3).unwrap()),
    WireGroup::new(Box::new(wire_b), NonZero::new(2).unwrap()),
]).is_ok());

Implementations

impl StrandedWire

pub fn new(wire_groups: Vec<WireGroup>) -> Result<Self, Error>

Returns a new stranded wire if the given vector of WireGroup fulfills the following conditions:

1. It is not empty.
2. All wires must have the same material.

Examples

use std::sync::Arc;
use std::num::NonZero;

use stem_wire::prelude::*;

let wire_a = RoundWire::new(
        Arc::new(Material::default()),
        Length::new::<millimeter>(0.5),
        Length::new::<millimeter>(0.0),
        Length::new::<millimeter>(0.1)
    ).unwrap();
let wire_b = RoundWire::new(
        Arc::new(Material::default()),
        Length::new::<millimeter>(0.4),
        Length::new::<millimeter>(0.0),
        Length::new::<millimeter>(0.1)
    ).unwrap();
let mut material = Material::default();

material.electrical_resistivity = ElectricalResistivity::new::<ohm_meter>(0.1).into();
let wire_c = RoundWire::new(
        Arc::new(material),
        Length::new::<millimeter>(0.4),
        Length::new::<millimeter>(0.0),
        Length::new::<millimeter>(0.1)
    ).unwrap();

assert!(StrandedWire::new(vec![
    WireGroup::new(Box::new(wire_a.clone()), NonZero::new(3).unwrap()),
    WireGroup::new(Box::new(wire_b), NonZero::new(2).unwrap()),
]).is_ok());

// Empty list
assert!(StrandedWire::new(Vec::new()).is_err());

// Not all wires have the same material
assert!(StrandedWire::new(vec![
    WireGroup::new(Box::new(wire_a), NonZero::new(3).unwrap()),
    WireGroup::new(Box::new(wire_c), NonZero::new(2).unwrap()),
]).is_err());

Trait Implementations

impl Clone for StrandedWire

fn clone(&self) -> StrandedWire

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StrandedWire

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StrandedWire

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 StrandedWire

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 StrandedWire

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.