summaryrefslogtreecommitdiff
path: root/gr-analog/include/gnuradio/analog/fastnoise_source.h
diff options
context:
space:
mode:
authorMarcus Müller <marcus@hostalia.de>2018-08-31 23:02:22 +0200
committerMarcus Müller <marcus@hostalia.de>2018-08-31 23:02:22 +0200
commit254fe5e89403d4de1fa6663d09efdf946996aff3 (patch)
tree62877d7ac7fdedf6c397c51e22ac6f97eba97ddf /gr-analog/include/gnuradio/analog/fastnoise_source.h
parent896d1c9da31963ecf5b0d90942c2af51ca998a69 (diff)
parent5ad935c3a3dd46ce2860b13e2b774e4841784616 (diff)
Merge remote-tracking branch 'origin/next' into merge_next
Diffstat (limited to 'gr-analog/include/gnuradio/analog/fastnoise_source.h')
-rw-r--r--gr-analog/include/gnuradio/analog/fastnoise_source.h94
1 files changed, 94 insertions, 0 deletions
diff --git a/gr-analog/include/gnuradio/analog/fastnoise_source.h b/gr-analog/include/gnuradio/analog/fastnoise_source.h
new file mode 100644
index 0000000000..28cb21b4ca
--- /dev/null
+++ b/gr-analog/include/gnuradio/analog/fastnoise_source.h
@@ -0,0 +1,94 @@
+/* -*- c++ -*- */
+/*
+ * Copyright 2013,2018 Free Software Foundation, Inc.
+ *
+ * This file is part of GNU Radio
+ *
+ * GNU Radio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3, or (at your option)
+ * any later version.
+ *
+ * GNU Radio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with GNU Radio; see the file COPYING. If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street,
+ * Boston, MA 02110-1301, USA.
+ */
+
+
+#ifndef FASTNOISE_SOURCE_H
+#define FASTNOISE_SOURCE_H
+
+#include <gnuradio/analog/api.h>
+#include <gnuradio/analog/noise_type.h>
+#include <gnuradio/sync_block.h>
+#include <vector>
+#include <cstdint>
+
+namespace gr {
+ namespace analog {
+
+ /*!
+ * \brief Random number source
+ * \ingroup source_blk
+ *
+ * \details
+ * Generate random values from different distributions.
+ * Currently, only Gaussian and uniform are enabled.
+ */
+template<class T>
+ class ANALOG_API fastnoise_source : virtual public sync_block
+ {
+ public:
+ // gr::analog::fastnoise_source::sptr
+ typedef boost::shared_ptr< fastnoise_source<T> > sptr;
+
+ /*! \brief Make a fast noise source
+ * \param type the random distribution to use (see
+ * gnuradio/analog/noise_type.h)
+ * \param ampl the standard deviation of a 1-d noise process. If
+ * this is the complex source, this parameter is split
+ * among the real and imaginary parts:
+ * <pre>(ampl/sqrt(2))x + j(ampl/sqrt(2))y</pre>
+ * \param seed seed for random generators. Note that for uniform
+ * and Gaussian distributions, this should be a negative
+ * number.
+ * \param samples Number of samples to pre-generate
+ */
+ static sptr make(noise_type_t type, float ampl,
+ long seed = 0, long samples=1024*16);
+ virtual T sample() = 0;
+ virtual T sample_unbiased() = 0;
+ virtual const std::vector<T>& samples() const = 0;
+
+ /*!
+ * Set the noise type. Nominally from the
+ * gr::analog::noise_type_t selections, but only GR_GAUSSIAN and
+ * GR_UNIFORM are currently available.
+ */
+ virtual void set_type(noise_type_t type) = 0;
+
+ /*!
+ * Set the standard deviation (amplitude) of the 1-d noise
+ * process.
+ */
+ virtual void set_amplitude(float ampl) = 0;
+
+ virtual noise_type_t type() const = 0;
+ virtual float amplitude() const = 0;
+ };
+
+ typedef fastnoise_source<float> fastnoise_source_f;
+ typedef fastnoise_source<std::int32_t> fastnoise_source_i;
+ typedef fastnoise_source<std::int16_t> fastnoise_source_s;
+ typedef fastnoise_source<gr_complex> fastnoise_source_c;
+ } /* namespace analog */
+} /* namespace gr */
+
+
+#endif /* FASTNOISE_SOURCE_H */