Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Image.not
Stay organized with collections
Save and categorize content based on your preferences.
Returns 0 if the input is non-zero, and 1 otherwise.
Usage | Returns | Image.not() | Image |
Argument | Type | Details | this: value | Image | The image to which the operation is applied. |
Examples
Code Editor (JavaScript)
/**
* Demonstrates the ee.Image.Not method.
*
* This example uses positive integers; non-integer and negative
* values are allowed.
*/
var notZeros = ee.Image(3); // Define an image where all pixels are not zero.
var zeros = notZeros.not(); // Pixels are not zeros, return zeros.
var ones = zeros.not(); // Pixels are zeros, return ones.
print('zeros:', zeros);
print('ones:', ones);
// Display images to the map; explore values using the Inspector.
var visParams = {min: 0, max: 1};
Map.addLayer(notZeros, visParams, 'notZeros');
Map.addLayer(zeros, visParams, 'zeros');
Map.addLayer(ones, visParams, 'ones');
Python setup
See the
Python Environment page for information on the Python API and using
geemap
for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
"""Demonstrates the ee.Image.Not method.
This example uses positive integers; non-integer and negative
values are allowed.
"""
import pprint
import ee
ee.Authenticate()
ee.Initialize()
not_zeros = ee.Image(3) # Define an image where all pixels are not zero.
zeros = not_zeros.Not() # Pixels are not zeros, return zeros.
ones = zeros.Not() # Pixels are zeros, return ones.
print('zeros:')
pprint.pprint(zeros.getInfo())
print('\nones:')
pprint.pprint(ones.getInfo())
# Sample images at a location and print the results.
loc = ee.Geometry.Point(0, 0) # Location to sample image values.
print('not_zeros:', not_zeros.sample(loc, 1).first().get('constant').getInfo())
print('zeros:', zeros.sample(loc, 1).first().get('constant').getInfo())
print('ones:', ones.sample(loc, 1).first().get('constant').getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eImage.not()\u003c/code\u003e method returns 0 for non-zero input values and 1 for zero input values in an image.\u003c/p\u003e\n"],["\u003cp\u003eThis operation can be applied to images containing integers, non-integers, and negative values.\u003c/p\u003e\n"],["\u003cp\u003eIt's useful for creating binary masks or inverting the logic of existing image data.\u003c/p\u003e\n"]]],[],null,["# ee.Image.not\n\nReturns 0 if the input is non-zero, and 1 otherwise.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------|---------|\n| Image.not`()` | Image |\n\n| Argument | Type | Details |\n|---------------|-------|----------------------------------------------|\n| this: `value` | Image | The image to which the operation is applied. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n/**\n * Demonstrates the ee.Image.Not method.\n *\n * This example uses positive integers; non-integer and negative\n * values are allowed.\n */\n\nvar notZeros = ee.Image(3); // Define an image where all pixels are not zero.\nvar zeros = notZeros.not(); // Pixels are not zeros, return zeros.\nvar ones = zeros.not(); // Pixels are zeros, return ones.\n\nprint('zeros:', zeros);\nprint('ones:', ones);\n\n// Display images to the map; explore values using the Inspector.\nvar visParams = {min: 0, max: 1};\nMap.addLayer(notZeros, visParams, 'notZeros');\nMap.addLayer(zeros, visParams, 'zeros');\nMap.addLayer(ones, visParams, 'ones');\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n\"\"\"Demonstrates the ee.Image.Not method.\n\nThis example uses positive integers; non-integer and negative\nvalues are allowed.\n\"\"\"\n\nimport pprint\nimport ee\nee.Authenticate()\nee.Initialize()\n\nnot_zeros = ee.Image(3) # Define an image where all pixels are not zero.\nzeros = not_zeros.Not() # Pixels are not zeros, return zeros.\nones = zeros.Not() # Pixels are zeros, return ones.\n\nprint('zeros:')\npprint.pprint(zeros.getInfo())\nprint('\\nones:')\npprint.pprint(ones.getInfo())\n\n# Sample images at a location and print the results.\nloc = ee.Geometry.Point(0, 0) # Location to sample image values.\nprint('not_zeros:', not_zeros.sample(loc, 1).first().get('constant').getInfo())\nprint('zeros:', zeros.sample(loc, 1).first().get('constant').getInfo())\nprint('ones:', ones.sample(loc, 1).first().get('constant').getInfo())\n```"]]