pub struct Position3D {
pub x_m: f64,
pub y_m: f64,
pub z_m: f64,
}Expand description
A Cartesian position in meters.
Coordinates are intentionally reference-frame agnostic. A topology may use local east/north/up coordinates, Earth-centered coordinates, or another consistent frame appropriate to the simulation.
Fields§
§x_m: f64X coordinate in meters.
y_m: f64Y coordinate in meters.
z_m: f64Z coordinate in meters.
Implementations§
Source§impl Position3D
impl Position3D
Sourcepub const fn new(x_m: f64, y_m: f64, z_m: f64) -> Self
pub const fn new(x_m: f64, y_m: f64, z_m: f64) -> Self
Creates a position from coordinates measured in meters.
Examples found in repository?
examples/moving_link.rs (line 17)
8fn main() -> Result<(), Box<dyn std::error::Error>> {
9 let network = NetworkConfig {
10 devices: vec![
11 DeviceConfig {
12 id: "aircraft".into(),
13 kind: DeviceKind::Source {
14 egress: "radio".into(),
15 },
16 mobility: MobilityModel::Linear {
17 position_at_epoch: Position3D::new(100_000.0, 0.0, 10_000.0),
18 velocity_mps: Velocity3D::new(-150.0, 0.0, 0.0),
19 epoch_ns: 0,
20 },
21 interference: vec![],
22 },
23 DeviceConfig {
24 id: "ground_station".into(),
25 kind: DeviceKind::Sink,
26 mobility: MobilityModel::Static {
27 position: Position3D::ORIGIN,
28 },
29 interference: vec![],
30 },
31 ],
32 channels: vec![ChannelConfig {
33 id: "radio".into(),
34 endpoints: ["aircraft".into(), "ground_station".into()],
35 bit_rate_bps: 10_000_000,
36 propagation_delay_ns: 50_000,
37 state: ChannelState::Operational,
38 distance: Some(DistanceChannel {
39 propagation_speed_mps: 299_792_458.0,
40 max_range_m: 120_000.0,
41 rate_model: DistanceRateModel::Linear {
42 full_rate_distance_m: 20_000.0,
43 minimum_bit_rate_bps: 1_000_000,
44 },
45 }),
46 radio: None,
47 }],
48 };
49
50 let mut simulator = Simulator::new(network)?;
51 simulator.schedule_send(SimTime::ZERO, "aircraft", "ground_station", vec![0; 1_000])?;
52 simulator.schedule_send(
53 SimTime::from_nanos(300_000_000_000),
54 "aircraft",
55 "ground_station",
56 vec![0; 1_000],
57 )?;
58 simulator.schedule_send(
59 SimTime::from_nanos(1_500_000_000_000),
60 "aircraft",
61 "ground_station",
62 vec![0; 1_000],
63 )?;
64
65 simulator.run_with(|event| match event {
66 NetworkEvent::TransmissionStarted {
67 at,
68 distance_mm,
69 effective_bit_rate_bps,
70 ..
71 } => println!(
72 "{at}: distance {:.1} km, rate {:.2} Mbit/s",
73 distance_mm.unwrap_or_default() as f64 / 1_000_000.0,
74 *effective_bit_rate_bps as f64 / 1_000_000.0,
75 ),
76 NetworkEvent::PacketDropped { at, reason, .. } => {
77 println!("{at}: packet dropped: {reason:?}");
78 }
79 _ => {}
80 })?;
81 Ok(())
82}Sourcepub fn distance_to(self, other: Self) -> f64
pub fn distance_to(self, other: Self) -> f64
Returns the Euclidean distance to another position in meters.
Trait Implementations§
Source§impl Clone for Position3D
impl Clone for Position3D
impl Copy for Position3D
Source§impl Debug for Position3D
impl Debug for Position3D
Source§impl Default for Position3D
impl Default for Position3D
Source§impl<'de> Deserialize<'de> for Position3D
impl<'de> Deserialize<'de> for Position3D
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
Source§impl PartialEq for Position3D
impl PartialEq for Position3D
Source§impl Serialize for Position3D
impl Serialize for Position3D
impl StructuralPartialEq for Position3D
Auto Trait Implementations§
impl Freeze for Position3D
impl RefUnwindSafe for Position3D
impl Send for Position3D
impl Sync for Position3D
impl Unpin for Position3D
impl UnsafeUnpin for Position3D
impl UnwindSafe for Position3D
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more