# Run forward step generations a popgen simulation

### Description

performs a time-forward, agent-based and spatiallly explicit genetic population simulation

### Usage

1 2 3 | ```
run.popgensim(simpops, steps, cost.mat, n.offspring, n.ind, mig.rate, disp.max,
disp.rate, n.allels, mut.rate, n.cov = 3, rec = "none",
emi.table = NULL)
``` |

### Arguments

`simpops` |
pops object (a list of pop) |

`steps` |
the number of steps (generations) |

`cost.mat` |
a cost matrix (e.g. calculated via costDistance) |

`n.offspring` |
number of offsprings per female |

`n.ind` |
number of individuals |

`mig.rate` |
migration rate |

`disp.max` |
maximal dispersal distance of disp.rate individuals |

`disp.rate` |
percentage of individuals achieving disp.max |

`n.allels` |
number of maximal alleles at a loci |

`mut.rate` |
mutation rate |

`n.cov` |
number of covariates (defaults to 3) |

`rec` |
switch if emigration matrix should be recorded, either "none" or "emi" |

`emi.table` |
a emigration matrix, if provide a fixed number of migration events will take place otherwise based on disp.max, mig.rate and disp.rate, events occuring are (in that order, emigration, reproduction, mutation) |

### Value

an updated simpops object after steps steps