# `make.lake`

[`make.lake`](#digger.make.lake) will modify an initial topobathymetric surface to add new water areas based on user-provided contours. This may be of use in areas that have batymetric surveys in the form of contours. The following is typical usage for [`make.lake`](#digger.make.lake).

A code snippet that uses [`make.lake`](#digger.make.lake) may be found in the file `digger/examples/pre-run/synthetic/make_lake_synthetic_example.py`. In this example, a synthetic lake is placed into flat topography.

```{literalinclude} ../../../../../examples/pre-run/synthetic/make_lake_synthetic_example.py
:language: python
```

After this code runs, it will produce geotif and [topotype3](https://www.clawpack.org/topo.html) files that specify the modified topobathymetry.

It will also create diagnostic figures.

In this example, we generated a lake from the following synthetic contour set:

```{figure} ../../../../_static/from_examples/herbie_contours.png
:alt: Contour set used by make.lake

The contour set used by make.lake
```

The standard diagnostic figure from [`make.lake`](#digger.make.lake)

```{figure} ../../../../_static/from_examples/lake_herbie.png
:alt: Example digger.make.lake summary figure.

An example of the diagnostic output provided by digger.make.lake.
```

A dictionary containing some diagnostic information is returned. It contains the following elements:

```{literalinclude} ../../../../_static/from_examples/lake_info.yaml
:language: yaml
```