計算字段示例 round(!Shape.area!,1)
使用鍵盤輸入值並不是編輯表中值的唯一方式。在某些情況下,為了設置字段值,可能要對單條記錄甚至是所有記錄執行數學計算。您可以對所有記錄或選中記錄執行簡單計算和高級計算。此外,還可以在屬性表中的字段上計算面積、長度、周長和其他幾何屬性。以下各部分包括使用字段計算器的若干示例。計算將通過 Python 執行。
注:
- Python 強制將縮進作為語法的一部分。請使用兩個或四個空格來定義每個邏輯級別。將語句塊的開頭和結尾對齊並且保持一致。
- Python 計算表達式字段將使用驚嘆號 (!!) 括起。
- 命名變量時,請注意 Python 區分大小寫,因此 value 不同於 Value。
- 輸入語句后,如果想將其寫入文件,可單擊導出。導入按鈕將提示您查找和選擇一個現有的計算文件。
簡單計算
簡單字符串示例
一系列 Python 字符串函數均支持使用字符串,包括 capitalize、rstrip 和 replace。
將字段 CITY_NAME 中字符串的首字母大寫。
!CITY_NAME!.capitalize()
去掉字段 CITY_NAME 中自字符串結尾起的所有空白區。
!CITY_NAME!.rstrip()
將字段 STATE_NAME 中出現的“california”全部替換為“California”。
!STATE_NAME!.replace("california", "California")
在 Python 中,字符串字段中的字符可以通過索引和分割操作進行訪問。索引操作將在索引位置提取字符,而分割操作則會提取一組字符。在下表中,假設 !fieldname! 是值為 "abcde" 的字符串字段。
示例 | 說明 | 結果 |
---|---|---|
!fieldname![0] |
第一個字符。 |
"a" |
!fieldname![-2] |
倒數第二個字符。 |
"d" |
!fieldname![1:4] |
第二、三和四個字符。 |
"bcd" |
Python 也支持使用 format() 方法的字符串格式。
將合並后的 FieldA 和 FieldB 以冒號分隔開。
"{}:{}".format(!FieldA!, !FieldB!)
簡單數學示例
Python 提供了處理數字的工具。Python 也支持一些數字和數學函數,包括 math、cmath、decimal、random、itertools、functools 和 operator。
運算符 | 說明 | 示例 | 結果 |
---|---|---|---|
x + y |
x 加上 y |
1.5 + 2.5 |
4.0 |
x - y |
x 減去 y |
3.3 - 2.2 |
1.1 |
x * y |
x 乘以 y |
2.0 * 2.2 |
4.4 |
x / y |
x 除以 y |
4.0 / 1.25 |
3.2 |
x // y |
x 除以 y(向下取整除法) |
4.0 // 1.25 |
3.0 |
x % y |
x 模 y |
8 % 3 |
2 |
-x |
x 的負數表達式 |
x = 5 -x |
-5 |
+x |
x 不變 |
x = 5 +x |
5 |
x ** y |
以 x 為底,以 y 為指數的冪 |
2 ** 3 |
8 |
乘
!Rank! * 2
根據給定的半徑字段計算球體的體積。
4.0 / 3.0 * math.pi * !Radius! ** 3
舊版本:
ArcGIS Pro 使用 Python 3,而 ArcGIS Desktop 使用 Python 2。 Python 2 使用的是整型數學計算,這就意味着兩個整型值相除將始終生成整型值 (3 / 2 = 1)。在 Python 3 中,兩個整型值相除將生成浮點型值 (3 / 2 = 1.5)。
Python 內置函數
Python 具有多個可用的內置函數,包括 max、min、round 和 sum。
通過字段列表計算每條記錄的最大值。
max([!field1!, !field2!, !field3!])
通過字段列表計算每條記錄的總和。
sum([!field1!, !field2!, !field3!])
使用代碼塊
通過 Python 表達式和代碼塊參數可執行以下操作:
- 在表達式中應用任意 Python 函數。
- 訪問地理處理函數和對象。
- 訪問要素幾何的屬性。
- 訪問新的隨機值運算符。
- 使用 if-then-else 邏輯對值進行重分類。
代碼塊的使用方式取決於表達式類型參數。在 ArcGIS Desktop 中,“計算字段”工具支持 VB、PYTHON 和 PYTHON_9.3 表達式類型。VB 表達式類型,在某些產品中受支持,但在 64 位產品中不受支持,其中包括 ArcGIS Pro、ArcGIS Desktop—Background Geoprocessing (64-bit) 以及 ArcGIS Server。在 ArcGIS Pro 中,將永久禁用表達式類型參數並會設置為 PYTHON_9.3。
表達式類型 | 代碼塊 |
---|---|
PYTHON_9.3 |
支持 Python 函數。使用 Python 函數 (def) 表示代碼塊。在適當的情況下,幾何屬性將通過地理處理對象表示(如點對象)。 使用工具對話框時不會顯示表達式類型,但會使用 PYTHON_9.3 類型。 |
PYTHON |
與 PYTHON_9.3 相同,但返回的是字符串而非幾何對象。 |
VB |
計算將通過 VBScript 執行。 |
各 Python 函數可通過 def 關鍵字定義,關鍵字后為函數名稱及函數的輸入參數。可編寫 Python 函數,使 Python 函數能夠接受任何數量的輸入參數(也可以沒有任何參數)。函數將通過 return 語句返回值。函數名稱可由您自行選取(不得使用空格,也不得以數字開頭)。
注:
如果函數未通過 return 語句顯式返回值,則函數將返回 None。
注:
請牢記,Python 強制要求將縮進作為語法的一部分。請使用四個空格來定義每個邏輯級別。將語句塊的開頭和結尾對齊並且保持一致。
代碼示例 - 數學
注:
為使用以下所有示例,請假設表達式類型為 PYTHON_9.3。
將字段的值四舍五入為保留兩位小數。
表達式:
round(!area!, 2)
通過 math 模塊將米轉換成英尺。以轉換值為底,以 2 為指數進行冪運算,然后再乘以 area。
表達式:
MetersToFeet((float(!shape.area!)))
代碼塊:
import math def MetersToFeet(area): return math.pow(3.2808, 2) * area
通過 Python 邏輯計算字段
按照字段值進行分類。
表達式:
Reclass(!WELL_YIELD!)
代碼塊:
def Reclass(WellYield): if (WellYield >= 0 and WellYield <= 10): return 1 elif (WellYield > 10 and WellYield <= 20): return 2 elif (WellYield > 20 and WellYield <= 30): return 3 elif (WellYield > 30): return 4
代碼實例 - 幾何
注:
有關轉換幾何單位的詳細信息,請參閱以下“幾何單位轉換”。
計算某要素的面積。
表達式:
!shape.area!
計算某要素的最大 x 坐標。
表達式:
!shape.extent.XMax!
計算某要素中的折點數。
表達式:
MySub(!shape!)
Code Block:
def MySub(feat): partnum = 0 # Count the number of points in the current multipart feature partcount = feat.partCount pntcount = 0 # Enter while loop for each part in the feature (if a singlepart # feature this will occur only once) # while partnum < partcount: part = feat.getPart(partnum) pnt = part.next() # Enter while loop for each vertex # while pnt: pntcount += 1 pnt = part.next() # If pnt is null, either the part is finished or there # is an interior ring # if not pnt: pnt = part.next() partnum += 1 return pntcount
將點要素類中每個點的 x 坐標平移 100。
表達式:
shiftXCoordinate(!SHAPE!)
Code Block:
def shiftXCoordinate(shape): shiftValue = 100 point = shape.getPart(0) point.X += shiftValue return point
幾何單位轉換
幾何字段的面積和長度屬性可通過用 @ 符號表示的單位類型進行修改。
- 面積測量單位關鍵字:
- ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | SQUAREMAPUNITS | UNKNOWN
- 線性測量單位關鍵字:
- CENTIMETERS | DECIMALDEGREES | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | POINTS | UNKNOWN | YARDS
注:
如果數據存儲在地理坐標系中且具有線性單位(例如英尺),則會通過測地線算法轉換長度計算的結果。
警告:
轉換地理坐標系中數據的面積單位會產生不正確的結果,這是由於沿 globe 的十進制度並不一致。
計算某要素的長度(以碼為單位)。
表達式:
!shape.length@yards!
計算某要素的面積(以英畝為單位)。
表達式:
!shape.area@acres!
測地線面積和長度也可以通過帶 geodesicArea(后跟測量單位關鍵字)的 geodesicLength 和 @ 屬性進行計算。
計算某要素的測地線長度(以碼為單位)。
表達式:
!shape.geodesicLength@yards!
計算某要素的測地線面積(以英畝為單位)。
表達式:
!shape.geodesicArea@acres!
代碼實例 - 日期
計算當前日期。
表達式:
time.strftime("%d/%m/%Y")
計算當前日期和時間。
表達式:
datetime.datetime.now()
計算的日期為 2000 年 12 月 31 日。
表達式:
datetime.datetime(2000, 12, 31)
計算當前日期和字段中的值之間的天數。
表達式:
(datetime.datetime.now() - arcpy.time.ParseDateTimeString(!field1!)).days
通過向字段中的日期值添加 100 天來計算日期。
表達式:
arcpy.time.ParseDateTimeString(!field1!) + datetime.timedelta(days=100)
計算字段中的日期值為一周中的周幾(例如,星期天)。
表達式:
arcpy.time.ParseDateTimeString(!field1!).strftime('%A')
代碼實例 - 字符串
返回最右側三個字符。
表達式:
!SUB_REGION![-3:]
將所有大寫字母 P 替換為小寫字母 p。
表達式:
!STATE_NAME!.replace("P","p")
通過空格分隔符串連兩個字段。
表達式:
!SUB_REGION! + " " + !STATE_ABBR!
轉換為正確的大小寫形式
下列各例顯示的是轉換單詞的不同方法,這些方法可使每個單詞的首字母變為大寫、其余字母變為小寫。
表達式:
' '.join([i.capitalize() for i in !STATE_NAME!.split(' ')])
表達式:
!STATE_NAME!.title()
正則表達式
Python 的 re 模塊提供了正則表達式匹配操作,可用於對字符串執行復雜的模式匹配和替換規則。
使用單詞 Street 替換 St 或 St.,在字符串的末尾生成一個新單詞。
表達式:
update_street(!ADDRESS!)
代碼塊:
import re def update_street(street_name): return re.sub(r"""\b(St|St.)\Z""", 'Street', street_name)
累加計算和順序計算
根據某間隔值計算順序 ID 或數字。
表達式:
autoIncrement()
代碼塊:
rec=0 def autoIncrement(): global rec pStart = 1 #adjust start value, if req'd pInterval = 1 #adjust interval value, if req'd if (rec == 0): rec = pStart else: rec = rec + pInterval return rec
計算數值型字段的累加值。
表達式:
accumulate(!FieldA!)
代碼塊:
total = 0 def accumulate(increment): global total if total: total += increment else: total = increment return total
計算數值型字段的百分比增量。
表達式:
percentIncrease(float(!FieldA!))
代碼塊:
lastValue = 0 def percentIncrease(newValue): global lastValue if lastValue: percentage = ((newValue - lastValue) / lastValue) * 100 else: percentage = 0 lastValue = newValue return percentage
隨機值
通過 numpy 站點包來計算 0.0 和 1.0 之間的隨機浮點值。
表達式:
getRandomValue()
代碼塊:
import numpy def getRandomValue(): return numpy.random.random()
使用隨機模塊來計算 0 與 10 之間的隨機整數。
表達式:
random.randint(0, 10) 代碼塊: import random
計算空值
如果使用 Python 表達式,可通過 Python None 來計算空值。
注:
僅當該字段為空時,才可以進行以下計算。
使用 Python None 計算空值。
表達式:
"None" 表達式類型: PYTHON_9.3