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

// This file is a part of the mori - Material Orientation Library in Rust
// Copyright 2018 Robert Carson
//
//    Licensed under the Apache License, Version 2.0 (the "License");
//    you may not use this file except in compliance with the License.
//    You may obtain a copy of the License at
//
//        http://www.apache.org/licenses/LICENSE-2.0
//
//    Unless required by applicable law or agreed to in writing, software
//    distributed under the License is distributed on an "AS IS" BASIS,
//    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//    See the License for the specific language governing permissions and
//    limitations under the License.

//! # Module: orientation
//!
//! This submodule contains methods related to the conversion of orientations from one to another.
//! It also contains methods directly related to orientations that are able to rotate vectors and 2nd order tensors.
//! It allows easy addition of new orientations in which one only has to add at least one conversion to an already existing orientation method.
//! Afterwards, all of the other orientations representations can be reached from one of the already existing orientation representations.

use super::*;
///It holds the necessary tools to create/view an array of Bunge angles. 
///Also, the conversion processes to other orientation representations.
pub mod bunge;
///It holds the necessary tools to create/view an array of rotation matrices. 
///Also, the conversion processes to other orientation representations.
///Finally, it holds the tools necessary to rotate matrices and 2nd order tensors.
pub mod rmat;
///It holds the necessary tools to create/view an array of axis-angle representations. 
///Also, the conversion processes to other orientation representations.
pub mod ang_axis;
///It holds the necessary tools to create/view an array of Rodrigues vectors. 
///Also, the conversion processes to other orientation representations.
pub mod rod_vec;
///It holds the necessary tools to create/view an array of compact axis-angle representations. 
///Also, the conversion processes to other orientation representations.
pub mod ang_axis_comp;
///It holds the necessary tools to create/view an array of compact Rodrigues vectors. 
///Also, the conversion processes to other orientation representations.
pub mod rod_vec_comp;
///It holds the necessary tools to create/view an array of unit quaterions.
///Also, the conversion processes to other orientation representations.
pub mod quat;

pub use self::bunge::*;
pub use self::rmat::*;
pub use self::ang_axis::*;
pub use self::ang_axis_comp::*;
pub use self::rod_vec::*;
pub use self::rod_vec_comp::*;
pub use self::quat::*;


#[derive(Clone, Debug)]
pub struct Homochoric{
    pub ori: Array2<f64>,
}

///A set of generic orientation conversions from one to another orientation representation 
pub trait OriConv{
    fn to_bunge(&self) -> Bunge;
    fn to_rmat(&self) -> RMat;
    fn to_ang_axis(&self) -> AngAxis;
    fn to_ang_axis_comp(&self) -> AngAxisComp;
    fn to_rod_vec(&self) -> RodVec;
    fn to_rod_vec_comp(&self) -> RodVecComp;
    fn to_quat(&self) -> Quat;
    fn to_homochoric(&self) -> Homochoric;
    fn to_bunge_inplace(&self, bunge: &mut Bunge);
    fn to_rmat_inplace(&self, rmat: &mut RMat);
    fn to_ang_axis_inplace(&self, ang_axis: &mut AngAxis);
    fn to_ang_axis_comp_inplace(&self, ang_axis_comp: &mut AngAxisComp);
    fn to_rod_vec_inplace(&self, rod_vec: &mut RodVec);
    fn to_rod_vec_comp_inplace(&self, rod_vec_comp: &mut RodVecComp);
    fn to_quat_inplace(&self, quat: &mut Quat);
    fn to_homochoric_inplace(&self, homochoric: &mut Homochoric);
}
///A set of methods that allow for rotations of supplied vector data (3x1) dim
pub trait RotVector{
    fn rot_vector(&self, vec: ArrayView2<f64>) -> Array2<f64>;
    fn rot_vector_mut(&self, vec: ArrayView2<f64>, rvec: ArrayViewMut2<f64>);
    fn rot_vector_inplace(&self, vec: ArrayViewMut2<f64>);
}
///A set of methods that allow for rotations of supplied 2nd order tensor data (3x3) dim
pub trait RotTensor{
    fn rot_tensor(&self, tensor: ArrayView3<f64>) -> Array3<f64>;
    fn rot_tensor_mut(&self, tensor: ArrayView3<f64>, rtensor: ArrayViewMut3<f64>);
    fn rot_tensor_inplace(&self, tensor: ArrayViewMut3<f64>);
}