HelpSource/Classes/Median.schelp

   1 class:: Median
   2 summary:: Median filter.
   3 categories::  UGens>Filters>Nonlinear
   4
   5
   6 Description::
   7
   8 Returns the median of the last length input points. This non-linear
   9 filter is good at reducing impulse noise from a signal.
  10
  11
  12 classmethods::
  13
  14 method::ar, kr
  15
  16 argument::length
  17
  18 Number of input points in which to find the median. Must be an
  19 odd number from 1 to 31. If
  20 code::length::  is 1
  21 then Median has no effect.
  22
  23
  24 argument::in
  25
  26 The input signal.
  27
  28
  29 argument::mul
  30
  31 Output will be multiplied by this value.
  32
  33
  34 argument::add
  35
  36 This value will be added to the output.
  37
  38
  39 Examples::
  40
  41 code::
  42
  43 // a signal with impulse noise.
  44 { Saw.ar(500, 0.1) + Dust2.ar(100, 0.9) }.play;
  45
  46 // after applying median filter
  47 { Median.ar(3, Saw.ar(500, 0.1) + Dust2.ar(100, 0.9)) }.play;
  48
  49 // The median length can be increased for longer duration noise.
  50
  51 // a signal with longer impulse noise.
  52 { Saw.ar(500, 0.1) + LPZ1.ar(Dust2.ar(100, 0.9)) }.play;
  53
  54 // length 3 doesn't help here because the impulses are 2 samples long.
  55 { Median.ar(3, Saw.ar(500, 0.1) + LPZ1.ar(Dust2.ar(100, 0.9))) }.play;
  56
  57 // length 5 does better
  58 { Median.ar(5, Saw.ar(500, 0.1) + LPZ1.ar(Dust2.ar(100, 0.9))) }.play;
  59
  60 // long Median filters begin chopping off the peaks of the waveform
  61 (
  62 {
  63         x = SinOsc.ar(1000, 0, 0.2);
  64         [x, Median.ar(31, x)]
  65 }.play;
  66 )
  67
  68 // another noise reduction application:
  69
  70 Synth.play({ WhiteNoise.ar(0.1) + SinOsc.ar(800,0,0.1) });
  71
  72 // use Median filter for high frequency noise
  73 Synth.play({ Median.ar(31, WhiteNoise.ar(0.1) + SinOsc.ar(800,0,0.1)) });
  74
  75 (
  76 // use LeakDC for low frequency noise
  77 Synth.play({
  78         LeakDC.ar(Median.ar(31, WhiteNoise.ar(0.1) + SinOsc.ar(800,0,0.1)), 0.9)
  79 });
  80 )
  81
  82 ::