gds 0.1.2

An interface to GDS files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

/// Contains some helper functions used in the gds crate.

extern crate byteorder;

use byteorder::{ByteOrder, BigEndian};

/// Convert a slice of bytes into a 32 bit real.
///
/// The used format is not conform to IEEE floats as it uses 16 as base and
/// excess 64 notation for the exponent. The first byte is used for the
/// exponent (bits 2-8) and the sign (bit 1).
pub fn bytes_to_gds_real32(bytes: &[u8]) -> f32 {
    let exp: i8 = ((0b01111111 & bytes[0]) as i8) - 64 - 6;
    let mut man_arr = [0;4];
    man_arr[1..].copy_from_slice(&bytes[1..]);
    let man_arr = man_arr;
    let man: f32 = BigEndian::read_u32(&man_arr) as f32;
    let base: f32 = 16.;
    if (0b10000000 & bytes[0]) == 0{
        man*base.powi(exp as i32)
    } else {
        -man*base.powi(exp as i32)
    }
}

/// Convert a slice of bytes into a 64 bit real.
///
/// The used format is not conform to IEEE floats as it uses 16 as base and
/// excess 64 notation for the exponent. The first byte is used for the
/// exponent (bits 2-8) and the sign (bit 1).
pub fn bytes_to_gds_real(bytes: &[u8]) -> f64 {
    let exp: i8 = ((0b01111111 & bytes[0]) as i8) - 64 - 14;
    let mut man_arr = [0;8];
    man_arr[1..].copy_from_slice(&bytes[1..]);
    let man: f64 = BigEndian::read_u64(&man_arr) as f64;
    let base: f64 = 16.;
    if (0b10000000 & bytes[0]) == 0{
        man*base.powi(exp as i32)
    } else {
        -man*base.powi(exp as i32)
    }
}

/// Converts a 64 bit real into a array of bytes.
///
/// The used format is not conform to IEEE floats as it uses 16 as base and
/// excess 64 notation for the exponent. The first byte is used for the
/// exponent (bits 2-8) and the sign (bit 1).
pub fn gds_real_to_bytes(r: f64) -> [u8;8] {
    let mut exp: u8 = 64;
    let mut man: f64 = r.abs();
    let base: f64 = 16.;
    if man != 0. {
        while man > 1. {
            man /= 16.;
            exp += 1;
        }
        while man < 1./16. {
            man *= 16.;
            exp -= 1;
        }
    }
    let man: u64 = (man*base.powi(14)) as u64;
    let mut man_arr = [0;8];
    BigEndian::write_u64(&mut man_arr,man);
    if r < 0. {
        exp |= 0b10000000;
    } else {
        exp &= 0b01111111;
    }
    let mut out_arr = [0;8];
    out_arr[0] = exp;
    out_arr[1..].copy_from_slice(&man_arr[1..8]);
    out_arr
}

/// Converts a 32 bit real into a array of bytes.
///
/// The used format is not conform to IEEE floats as it uses 16 as base and
/// excess 64 notation for the exponent. The first byte is used for the
/// exponent (bits 2-8) and the sign (bit 1).
pub fn gds_real_32_to_bytes(r: f32) -> [u8;4] {
    let mut exp: u8 = 64;
    let mut man: f32 = r.abs();
    let base: f32 = 16.;
    if man != 0. {
        while man > 1. {
            man /= 16.;
            exp += 1;
        }
        while man < 1./16. {
            man *= 16.;
            exp -= 1;
        }
    }
    let man: u32 = (man*base.powi(6)) as u32;
    let mut man_arr = [0;4];
    BigEndian::write_u32(&mut man_arr,man);
    if r < 0. {
        exp |= 0b10000000;
    } else {
        exp &= 0b01111111;
    }
    let mut out_arr = [0;4];
    out_arr[0] = exp;
    out_arr[1..].copy_from_slice(&man_arr[1..4]);
    out_arr
}

/// Converts a 16 bit signed integer into a vector of bytes.
pub fn i16_to_vec(i: i16) -> Vec<u8> {
    let mut buf: [u8;2] = [0;2];
    BigEndian::write_i16(&mut buf,i);
    buf.to_vec()
}

/// Converts a 16 bit unsigned integer into a vector of bytes.
pub fn u16_to_vec(i: u16) -> Vec<u8> {
    let mut buf: [u8;2] = [0;2];
    BigEndian::write_u16(&mut buf,i);
    buf.to_vec()
}

/// Converts a 32 bit signed integer into a vector of bytes.
pub fn i32_to_vec(i: i32) -> Vec<u8> {
    let mut buf: [u8;4] = [0;4];
    BigEndian::write_i32(&mut buf,i);
    buf.to_vec()
}

/// Converts a 32 bit unsigned integer into a vector of bytes.
pub fn u32_to_vec(i: u32) -> Vec<u8> {
    let mut buf: [u8;4] = [0;4];
    BigEndian::write_u32(&mut buf,i);
    buf.to_vec()
}