# ee.Dictionary.toImage

Creates an image of constants from values in a dictionary. The bands of the image are ordered and named according to the names argument. If no names are specified, the bands are sorted alpha-numerically.

<br />

| Usage | Returns |
|---|---|
| `Dictionary.toImage(*names*)` | Image |

| Argument | Type | Details |
|---|---|---|
| this: `dictionary` | Dictionary | The dictionary to convert. |
| `names` | List, default: null | The order of the output bands. |

## Examples

### Code Editor (JavaScript)

```javascript
// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
  B1: 182,
  B2: 219,
  B3: 443
});

var selectedKeysImg = dict.toImage(['B1', 'B2']);
print('Selected keys image band names', selectedKeysImg.bandNames());

var allKeysImg = dict.toImage();
print('All keys image band names', allKeysImg.bandNames());
```
Python setup

See the [Python Environment](https://developers.google.com/earth-engine/guides/python_install) page for information on the Python API and using
`geemap` for interactive development.

```python
import ee
import geemap.core as geemap
```

### Colab (Python)

```python
# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
    'B1': 182,
    'B2': 219,
    'B3': 443
})

selected_keys_img = dic.toImage(['B1', 'B2'])
display('Selected keys image band names:',
        selected_keys_img.bandNames())

all_keys_img = dic.toImage()
display('All keys image band names:', all_keys_img.bandNames())
```