ee.Number.bitCount

  • Determines the quantity of one-bits (or set bits) present in the binary representation of a number.

  • Accepts a single numerical input and returns the count of one-bits as a number.

  • Operates on the 64-bit two's complement binary representation of the input number, ensuring compatibility with signed values.

  • Provides functionality in both JavaScript and Python environments within the Earth Engine platform.

  • Examples demonstrate the usage of the function with various inputs including positive, negative and hexadecimal numbers.

 Calculates the number of one-bits in the 64-bit two's complement binary representation of the input.

UsageReturns
Number.bitCount()Number
ArgumentTypeDetails
this: inputNumberThe input value.

Examples

Code Editor (JavaScript)

print(ee.Number(0).bitCount());       // [0]
print(ee.Number(1).bitCount());       // [1]
print(ee.Number(2).bitCount());       // [1]
print(ee.Number(3).bitCount());       // [2]
print(ee.Number(0xFFFF).bitCount());  // [16]

// https://en.wikipedia.org/wiki/Two's_complement signed values.
print(ee.Number(-1).bitCount());                       // [64]
print(ee.Number(-1, ee.PixelType.int8()).bitCount());  // [64]
print(ee.Number(-2).bitCount());                       // [63]

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)

print(ee.Number(0).bitCount().getInfo())       # [0]
print(ee.Number(1).bitCount().getInfo())       # [1]
print(ee.Number(2).bitCount().getInfo())       # [1]
print(ee.Number(3).bitCount().getInfo())       # [2]
print(ee.Number(0xFFFF).bitCount().getInfo())  # [16]

# https://en.wikipedia.org/wiki/Two's_complement signed values.
print(ee.Number(-1).bitCount().getInfo())                       # [64]
print(ee.Number(-1).toInt8().bitCount().getInfo())              # [64]
print(ee.Number(-2).bitCount().getInfo())                       # [63]