公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取 Earth Engine。
ee.Number.expression
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
計算數字運算式。
用量 | 傳回 |
---|
ee.Number.expression(expression, vars) | 數字 |
引數 | 類型 | 詳細資料 |
---|
expression | 字串 | 要評估的數學運算式字串。除了標準算術、布林和關係運算子,運算式也支援 Number 中的任何函式、從「vars」字典擷取子元素的「.」運算子,以及數學常數 Math.PI 和 Math.E。 |
vars | 字典,預設值:null | 可在運算式中使用的具名值字典。 |
範例
程式碼編輯器 (JavaScript)
// A dictionary of variables to use in expression.
var variables = {x: 5, y: 10};
// Arithmetic operators.
print('x + y',
ee.Number.expression('x + y', variables));
print('x - y',
ee.Number.expression('x - y', variables));
print('x * y',
ee.Number.expression('x * y', variables));
print('x / y',
ee.Number.expression('x / y', variables));
print('x ** y',
ee.Number.expression('x ** y', variables));
print('x % y',
ee.Number.expression('x % y', variables));
// Logical operators.
print('x || y',
ee.Number.expression('x || y', variables));
print('x && y',
ee.Number.expression('x && y', variables));
print('!(x)',
ee.Number.expression('!(x)', variables));
// Relational operators.
print('x > y',
ee.Number.expression('x > y', variables));
print('x >= y',
ee.Number.expression('x >= y', variables));
print('x < y',
ee.Number.expression('x < y', variables));
print('x <= y',
ee.Number.expression('x <= y', variables));
print('x == y',
ee.Number.expression('x == y', variables));
print('x != y',
ee.Number.expression('x != y', variables));
// Conditional (ternary) operator.
print('(x < y) ? 100 : 1000)',
ee.Number.expression('(x < y) ? 100 : 1000', variables));
// Constants in the expression.
print('100 * (x + y)',
ee.Number.expression('100 * (x + y)', variables));
// JavaScript Math constants.
print('Math.PI',
ee.Number.expression('Math.PI', null));
print('Math.E',
ee.Number.expression('Math.E', null));
// Dot notation to call on child elements.
print('Use dot notation to call on child elements',
ee.Number.expression('vals.x * vals.y', {vals: variables}));
// ee.Number functions.
print('Use ee.Number add: add(x, y)',
ee.Number.expression('add(x, y)', variables));
print('Use ee.Number add and subtract: subtract(add(x, y), 5)',
ee.Number.expression('subtract(add(x, y), 5)', variables));
Python 設定
請參閱
Python 環境頁面,瞭解 Python API 和如何使用 geemap
進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A dictionary of variables to use in expression.
variables = {'x': 5, 'y': 10}
# Arithmetic operators.
print('x + y:',
ee.Number.expression('x + y', variables).getInfo())
print('x - y:',
ee.Number.expression('x - y', variables).getInfo())
print('x * y:',
ee.Number.expression('x * y', variables).getInfo())
print('x / y:',
ee.Number.expression('x / y', variables).getInfo())
print('x ** y:',
ee.Number.expression('x ** y', variables).getInfo())
print('x % y:',
ee.Number.expression('x % y', variables).getInfo())
# Logical operators.
print('x || y:',
ee.Number.expression('x || y', variables).getInfo())
print('x && y:',
ee.Number.expression('x && y', variables).getInfo())
print('!(x):',
ee.Number.expression('!(x)', variables).getInfo())
# Relational operators.
print('x > y:',
ee.Number.expression('x > y', variables).getInfo())
print('x >= y:',
ee.Number.expression('x >= y', variables).getInfo())
print('x < y:',
ee.Number.expression('x < y', variables).getInfo())
print('x <= y:',
ee.Number.expression('x <= y', variables).getInfo())
print('x == y:',
ee.Number.expression('x == y', variables).getInfo())
print('x != y:',
ee.Number.expression('x != y', variables).getInfo())
# Conditional JavaScript (ternary) operator.
print('(x < y) ? 100 : 1000):',
ee.Number.expression('(x < y) ? 100 : 1000', variables).getInfo())
# Constants in the expression.
print('100 * (x + y):',
ee.Number.expression('100 * (x + y)', variables).getInfo())
# JavaScript Math constants.
print('Math.PI:',
ee.Number.expression('Math.PI', None).getInfo())
print('Math.E:',
ee.Number.expression('Math.E', None).getInfo())
# Dot notation to call on child elements.
print('Use dot notation to call on child elements:',
ee.Number.expression('vals.x * vals.y', {'vals': variables}).getInfo())
# ee.Number functions.
print('Use ee.Number add. add(x, y):',
ee.Number.expression('add(x, y)', variables).getInfo())
print('Use ee.Number add and subtract. subtract(add(x, y), 5):',
ee.Number.expression('subtract(add(x, y), 5)', variables).getInfo())
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-29 (世界標準時間)。
[null,null,["上次更新時間:2025-07-29 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eee.Number.expression\u003c/code\u003e computes a numeric expression provided as a string.\u003c/p\u003e\n"],["\u003cp\u003eIt supports standard arithmetic, boolean, relational operators, as well as \u003ccode\u003eee.Number\u003c/code\u003e functions, and mathematical constants.\u003c/p\u003e\n"],["\u003cp\u003eA dictionary of variables can be passed to the function to be used within the expression.\u003c/p\u003e\n"],["\u003cp\u003eDot notation can be utilized within the expression to access child elements of variables provided in the dictionary.\u003c/p\u003e\n"]]],["`ee.Number.expression` evaluates a mathematical expression string. It accepts an `expression` string and an optional `vars` dictionary containing named values. The expression supports arithmetic, boolean, and relational operators, as well as functions found in `ee.Number` and constants like `Math.PI` and `Math.E`. Dot notation accesses nested dictionary elements. The function returns a numerical result, allowing complex computations. Examples include adding, subtracting, multiplying, applying logical operations, and conditional logic.\n"],null,["# ee.Number.expression\n\nComputes a numeric expression.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------------|---------|\n| `ee.Number.expression(expression, `*vars*`)` | Number |\n\n| Argument | Type | Details |\n|--------------|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | String | A mathematical expression string to be evaluated. In addition to the standard arithmetic, boolean and relational operators, expressions also support any function in Number, the '.' operator to extract child elements from the 'vars' dictionary, and mathematical constants Math.PI and Math.E. |\n| `vars` | Dictionary, default: null | A dictionary of named values that can be used in the expression. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A dictionary of variables to use in expression.\nvar variables = {x: 5, y: 10};\n\n// Arithmetic operators.\nprint('x + y',\n ee.Number.expression('x + y', variables));\nprint('x - y',\n ee.Number.expression('x - y', variables));\nprint('x * y',\n ee.Number.expression('x * y', variables));\nprint('x / y',\n ee.Number.expression('x / y', variables));\nprint('x ** y',\n ee.Number.expression('x ** y', variables));\nprint('x % y',\n ee.Number.expression('x % y', variables));\n\n// Logical operators.\nprint('x || y',\n ee.Number.expression('x || y', variables));\nprint('x && y',\n ee.Number.expression('x && y', variables));\nprint('!(x)',\n ee.Number.expression('!(x)', variables));\n\n// Relational operators.\nprint('x \u003e y',\n ee.Number.expression('x \u003e y', variables));\nprint('x \u003e= y',\n ee.Number.expression('x \u003e= y', variables));\nprint('x \u003c y',\n ee.Number.expression('x \u003c y', variables));\nprint('x \u003c= y',\n ee.Number.expression('x \u003c= y', variables));\nprint('x == y',\n ee.Number.expression('x == y', variables));\nprint('x != y',\n ee.Number.expression('x != y', variables));\n\n// Conditional (ternary) operator.\nprint('(x \u003c y) ? 100 : 1000)',\n ee.Number.expression('(x \u003c y) ? 100 : 1000', variables));\n\n// Constants in the expression.\nprint('100 * (x + y)',\n ee.Number.expression('100 * (x + y)', variables));\n\n// JavaScript Math constants.\nprint('Math.PI',\n ee.Number.expression('Math.PI', null));\nprint('Math.E',\n ee.Number.expression('Math.E', null));\n\n// Dot notation to call on child elements.\nprint('Use dot notation to call on child elements',\n ee.Number.expression('vals.x * vals.y', {vals: variables}));\n\n// ee.Number functions.\nprint('Use ee.Number add: add(x, y)',\n ee.Number.expression('add(x, y)', variables));\nprint('Use ee.Number add and subtract: subtract(add(x, y), 5)',\n ee.Number.expression('subtract(add(x, y), 5)', variables));\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# A dictionary of variables to use in expression.\nvariables = {'x': 5, 'y': 10}\n\n# Arithmetic operators.\nprint('x + y:',\n ee.Number.expression('x + y', variables).getInfo())\nprint('x - y:',\n ee.Number.expression('x - y', variables).getInfo())\nprint('x * y:',\n ee.Number.expression('x * y', variables).getInfo())\nprint('x / y:',\n ee.Number.expression('x / y', variables).getInfo())\nprint('x ** y:',\n ee.Number.expression('x ** y', variables).getInfo())\nprint('x % y:',\n ee.Number.expression('x % y', variables).getInfo())\n\n# Logical operators.\nprint('x || y:',\n ee.Number.expression('x || y', variables).getInfo())\nprint('x && y:',\n ee.Number.expression('x && y', variables).getInfo())\nprint('!(x):',\n ee.Number.expression('!(x)', variables).getInfo())\n\n# Relational operators.\nprint('x \u003e y:',\n ee.Number.expression('x \u003e y', variables).getInfo())\nprint('x \u003e= y:',\n ee.Number.expression('x \u003e= y', variables).getInfo())\nprint('x \u003c y:',\n ee.Number.expression('x \u003c y', variables).getInfo())\nprint('x \u003c= y:',\n ee.Number.expression('x \u003c= y', variables).getInfo())\nprint('x == y:',\n ee.Number.expression('x == y', variables).getInfo())\nprint('x != y:',\n ee.Number.expression('x != y', variables).getInfo())\n\n# Conditional JavaScript (ternary) operator.\nprint('(x \u003c y) ? 100 : 1000):',\n ee.Number.expression('(x \u003c y) ? 100 : 1000', variables).getInfo())\n\n# Constants in the expression.\nprint('100 * (x + y):',\n ee.Number.expression('100 * (x + y)', variables).getInfo())\n\n# JavaScript Math constants.\nprint('Math.PI:',\n ee.Number.expression('Math.PI', None).getInfo())\nprint('Math.E:',\n ee.Number.expression('Math.E', None).getInfo())\n\n# Dot notation to call on child elements.\nprint('Use dot notation to call on child elements:',\n ee.Number.expression('vals.x * vals.y', {'vals': variables}).getInfo())\n\n# ee.Number functions.\nprint('Use ee.Number add. add(x, y):',\n ee.Number.expression('add(x, y)', variables).getInfo())\nprint('Use ee.Number add and subtract. subtract(add(x, y), 5):',\n ee.Number.expression('subtract(add(x, y), 5)', variables).getInfo())\n```"]]