libosmodsp 0.4.0.8-9128
Osmocom DSP library
iqbal.h
Go to the documentation of this file.
1/*
2 * iqbal.h
3 *
4 * IQ balance correction / estimation utilities
5 *
6 * Copyright (C) 2013 Sylvain Munaut <tnt@246tNt.com>
7 *
8 * All Rights Reserved
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 */
24
25#ifndef __OSMO_DSP_IQBAL_H__
26#define __OSMO_DSP_IQBAL_H__
27
36#include <complex.h>
37
38#include <osmocom/dsp/cxvec.h>
39
40
41/* IQ balance correction and estimation */
42
43void osmo_iqbal_fix(float complex *out, float complex *in, unsigned int len,
44 float mag, float phase);
45
46struct osmo_cxvec *
47osmo_iqbal_cxvec_fix(const struct osmo_cxvec *in, float mag, float phase,
48 struct osmo_cxvec *out);
49
50float
51osmo_iqbal_estimate(const float complex *data,
52 int fft_size, int fft_count);
53
54float
56 int fft_size, int fft_count);
57
58
59/* IQ balance optimization */
60
67};
68
70
71int
72osmo_iqbal_cxvec_optimize(const struct osmo_cxvec *sig, float *mag, float *phase,
73 const struct osmo_iqbal_opts *opts);
74
77#endif /* __OSMO_DSP_IQBAL_H__ */
Osmocom Complex vectors header.
float osmo_iqbal_cxvec_estimate(const struct osmo_cxvec *sig, int fft_size, int fft_count)
Objectively estimate IQ balance in a given complex vector.
Definition: iqbal.c:206
float osmo_iqbal_estimate(const float complex *data, int fft_size, int fft_count)
Objectively estimate IQ balance in a given complex buffer.
Definition: iqbal.c:194
const struct osmo_iqbal_opts osmo_iqbal_default_opts
Default values for the optimization algorithm.
Definition: iqbal.c:221
struct osmo_cxvec * osmo_iqbal_cxvec_fix(const struct osmo_cxvec *in, float mag, float phase, struct osmo_cxvec *out)
Apply IQ balance correction to a given complex vector.
Definition: iqbal.c:94
void osmo_iqbal_fix(float complex *out, float complex *in, unsigned int len, float mag, float phase)
Apply IQ balance correction to a given complex buffer.
Definition: iqbal.c:71
int osmo_iqbal_cxvec_optimize(const struct osmo_cxvec *sig, float *mag, float *phase, const struct osmo_iqbal_opts *opts)
Finds the best IQ balance correction parameters for a given signal.
Definition: iqbal.c:301
Complex vector.
Definition: cxvec.h:41
float complex * data
Data field.
Definition: cxvec.h:45
Processing options for the IQ balance optimization algorithm.
Definition: iqbal.h:62
int fft_size
FFT size to use.
Definition: iqbal.h:63
int fft_count
Number of FFT to use.
Definition: iqbal.h:64
int max_iter
Max # iterations per pass.
Definition: iqbal.h:65
int start_at_prev
Use prev values as starting point.
Definition: iqbal.h:66