Note that this reference documentation is identical to the help that is displayed in MATLAB when you type “help ft_dipolesimulation”.

  FT_DIPOLESIMULATION computes the field or potential of a simulated dipole
  and returns a datastructure identical to the FT_PREPROCESSING function.
 
  Use as
    data = ft_dipolesimulation(cfg)
 
  The dipoles position and orientation have to be specified with
    cfg.dip.pos     = [Rx Ry Rz] (size Nx3)
    cfg.dip.mom     = [Qx Qy Qz] (size 3xN)
 
  The timecourse of the dipole activity is given as a single vector or as a
  cell-array with one vectors per trial
    cfg.dip.signal
  or by specifying a sine-wave signal
    cfg.dip.frequency    in Hz
    cfg.dip.phase        in radians
    cfg.dip.amplitude    per dipole
    cfg.ntrials          number of trials
    cfg.triallength      time in seconds
    cfg.fsample          sampling frequency in Hz
 
  Random white noise can be added to the data in each trial, either by
  specifying an absolute or a relative noise level
    cfg.relnoise    = add noise with level relative to simulated signal
    cfg.absnoise    = add noise with absolute level
    cfg.randomseed  = 'yes' or a number or vector with the seed value (default = 'yes')
 
  Optional input arguments are
    cfg.channel    = Nx1 cell-array with selection of channels (default = 'all'),
                     see FT_CHANNELSELECTION for details
    cfg.dipoleunit = units for dipole amplitude (default nA*m)
    cfg.chanunit   = units for the channel data
 
  The volume conduction model of the head should be specified as
    cfg.headmodel     = structure with volume conduction model, see FT_PREPARE_HEADMODEL
 
  The EEG or MEG sensor positions should be specified as
    cfg.elec          = structure with electrode positions, see FT_DATATYPE_SENS
    cfg.grad          = structure with gradiometer definition, see FT_DATATYPE_SENS
    cfg.elecfile      = name of file containing the electrode positions, see FT_READ_SENS
    cfg.gradfile      = name of file containing the gradiometer definition, see FT_READ_SENS
 
  See also FT_SOURCEANALYSIS, FT_DIPOLEFITTING, FT_TIMELOCKSIMULATION,
  FT_FREQSIMULATION, FT_CONNECTIVITYSIMULATION