# layer()

Picks up one layer by name.

Use the name exactly as it appears on screen. If it has brackets, as in `[Base]`, include the brackets. An unknown name raises `LayerError`. Two layers with the same name also raise `LayerError`, because the call cannot tell them apart. Rename one of them in the layer panel first.

### Signature
```python
api.layer(name) -> layer
```

### Example
```python
layer = api.layer("Layer 1")
print(layer.name, layer.visible, layer.id)
layer.set_visible(False)
```