Описание тега flatmap

Flat Map работает, применяя функцию, которая возвращает последовательность для каждого элемента в списке, и объединяет результаты в исходный список. Это легче показать, чем объяснить:

scala> def g(v:Int) = List(v-1, v, v+1)
g: (v: Int)List[Int]

scala> l.map(x => g(x))
res64: List[List[Int]] = List(List(0, 1, 2), List(1, 2, 3), List(2, 3, 4), List(3, 4, 5), List(4, 5, 6))

scala> l.flatMap(x => g(x))
res65: List[Int] = List(0, 1, 2, 1, 2, 3, 2, 3, 4, 3, 4, 5, 4, 5, 6)

Источник: http://www.brunton-spall.co.uk/post/2011/12/02/map-map-and-flatmap-in-scala/