====== Insert Layer Map ====== 

===== Description =====

This functor inserts a layer in a map in a certain position with a given name.

===== Inputs =====

^ Name  ^ Type  ^ Description  ^
| Map  | [[Map Type]]  | Map where the layer will be inserted.   |
| Layer  | [[Map Type]]  | Map whose first layer will be inserted in Map.   |
| Layer Position  | [[Positive Integer Value Type]]  | Position where the layer will be inserted in the map. If the position is higher than the current number of layers in the map, the new layer will be placed in the last position. |

===== Optional Inputs =====

^ Name  ^ Type  ^ Description  ^ Default Value  ^
| Layer Name  | [[Name Type]]  | Name the layer will have in the map. A unique name is required. If None, an automatic unique name will be generated.  | None  |
| Replace Layer  | [[Boolean Value Type]]  | If true, replace the layer at the given position with the new layer. Otherwise, the layer located at the given position (and all following layers) is shifted to the next position to accommodate the new layer.  | False  |

===== Output =====

^ Name  ^ Type  ^ Description  ^
| Map  | [[Map Type]]  | Map containing the new layer.  |

===== Group =====

[[Functor List#Map Algebra|Map Algebra]]

===== Internal Name =====

InsertMapLayer