1 //=================================================================================================
2 /*!
3 //  \file blaze/math/DynamicVector.h
4 //  \brief Header file for the complete DynamicVector implementation
5 //
6 //  Copyright (C) 2012-2020 Klaus Iglberger - All Rights Reserved
7 //
8 //  This file is part of the Blaze library. You can redistribute it and/or modify it under
9 //  the terms of the New (Revised) BSD License. Redistribution and use in source and binary
10 //  forms, with or without modification, are permitted provided that the following conditions
11 //  are met:
12 //
13 //  1. Redistributions of source code must retain the above copyright notice, this list of
14 //     conditions and the following disclaimer.
15 //  2. Redistributions in binary form must reproduce the above copyright notice, this list
16 //     of conditions and the following disclaimer in the documentation and/or other materials
17 //     provided with the distribution.
18 //  3. Neither the names of the Blaze development group nor the names of its contributors
19 //     may be used to endorse or promote products derived from this software without specific
20 //     prior written permission.
21 //
22 //  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
23 //  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 //  OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
25 //  SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26 //  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
27 //  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
28 //  BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 //  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
30 //  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
31 //  DAMAGE.
32 */
33 //=================================================================================================
34 
35 #ifndef _BLAZE_MATH_DYNAMICVECTOR_H_
36 #define _BLAZE_MATH_DYNAMICVECTOR_H_
37 
38 
39 //*************************************************************************************************
40 // Includes
41 //*************************************************************************************************
42 
43 #include <blaze/math/dense/DynamicVector.h>
44 #include <blaze/math/dense/StaticVector.h>
45 #include <blaze/math/DenseVector.h>
46 #include <blaze/math/DynamicMatrix.h>
47 #include <blaze/math/ZeroVector.h>
48 #include <blaze/util/Random.h>
49 
50 
51 namespace blaze {
52 
53 //=================================================================================================
54 //
55 //  RAND SPECIALIZATION
56 //
57 //=================================================================================================
58 
59 //*************************************************************************************************
60 /*! \cond BLAZE_INTERNAL */
61 /*!\brief Specialization of the Rand class template for DynamicVector.
62 // \ingroup random
63 //
64 // This specialization of the Rand class creates random instances of DynamicVector.
65 */
66 template< typename Type   // Data type of the vector
67         , bool TF         // Transpose flag
68         , typename Tag >  // Type tag
69 class Rand< DynamicVector<Type,TF,Tag> >
70 {
71  public:
72    //**********************************************************************************************
73    /*!\brief Generation of a random DynamicVector.
74    //
75    // \param n The size of the random vector.
76    // \return The generated random vector.
77    */
generate(size_t n)78    inline const DynamicVector<Type,TF,Tag> generate( size_t n ) const
79    {
80       DynamicVector<Type,TF,Tag> vector( n );
81       randomize( vector );
82       return vector;
83    }
84    //**********************************************************************************************
85 
86    //**********************************************************************************************
87    /*!\brief Generation of a random DynamicVector.
88    //
89    // \param n The size of the random vector.
90    // \param min The smallest possible value for a vector element.
91    // \param max The largest possible value for a vector element.
92    // \return The generated random vector.
93    */
94    template< typename Arg >  // Min/max argument type
generate(size_t n,const Arg & min,const Arg & max)95    inline const DynamicVector<Type,TF,Tag> generate( size_t n, const Arg& min, const Arg& max ) const
96    {
97       DynamicVector<Type,TF,Tag> vector( n );
98       randomize( vector, min, max );
99       return vector;
100    }
101    //**********************************************************************************************
102 
103    //**********************************************************************************************
104    /*!\brief Randomization of a DynamicVector.
105    //
106    // \param vector The vector to be randomized.
107    // \return void
108    */
randomize(DynamicVector<Type,TF,Tag> & vector)109    inline void randomize( DynamicVector<Type,TF,Tag>& vector ) const
110    {
111       using blaze::randomize;
112 
113       const size_t size( vector.size() );
114       for( size_t i=0UL; i<size; ++i ) {
115          randomize( vector[i] );
116       }
117    }
118    //**********************************************************************************************
119 
120    //**********************************************************************************************
121    /*!\brief Randomization of a DynamicVector.
122    //
123    // \param vector The vector to be randomized.
124    // \param min The smallest possible value for a vector element.
125    // \param max The largest possible value for a vector element.
126    // \return void
127    */
128    template< typename Arg >  // Min/max argument type
randomize(DynamicVector<Type,TF,Tag> & vector,const Arg & min,const Arg & max)129    inline void randomize( DynamicVector<Type,TF,Tag>& vector,
130                           const Arg& min, const Arg& max ) const
131    {
132       using blaze::randomize;
133 
134       const size_t size( vector.size() );
135       for( size_t i=0UL; i<size; ++i ) {
136          randomize( vector[i], min, max );
137       }
138    }
139    //**********************************************************************************************
140 };
141 /*! \endcond */
142 //*************************************************************************************************
143 
144 } // namespace blaze
145 
146 #endif
147