- Support Home >
- Knowledge Base >
- Technical Articles >
- Article Detail
HowTo: Use VBA functions in the field calculator
| Article ID: | 31807 |
|---|---|
| Software: | ArcGIS - ArcEditor 8.3, 9.0, 9.1, 9.2, 9.3, 9.3.1 ArcGIS - ArcInfo 8.3, 9.0, 9.1, 9.2, 9.3, 9.3.1 ArcGIS - ArcView 8.3, 9.0, 9.1, 9.2, 9.3, 9.3.1 |
| Platforms: | N/A |
Summary
For more information on using the Field Calculator, consult the ArcGIS help documentation. To access this documentation:
- Open the field Calculator dialog box and click the Help button.
- Open the ArcGIS Desktop Help and go to the Index Tab > Calculating > Fields in Attribute Tables > Making Field Calculations.
There is also a help topic for working with date fields in the field calculator:
-Open the ArcGIS DT Help and go to the Index Tab > Calculating > Fields in Attribute Tables > Working with Date Fields.
The scope of this article is to demonstrate some common VBA functions that can be used within the Field Calculator.
Procedure
Note: In the VBA function syntax below, optional parameters are shown in square brackets ([ ]). In the examples, field names are shows in square brackets.
- Left Function
Returns a Variant (String) containing a specified number of characters from the left side of a string.
Syntax
Left(string, length)
Left Function Example
MyStr = Left([MyField], 1)
- Right Function
Returns a Variant (String) containing a specified number of characters from the right side of a string.
Syntax
Right(string, length)
Right Function Example
MyStr = Right([MyField], 1)
- Mid Function
Returns a Variant (String) containing a specified number of characters from a string.
Syntax
Mid(string, start[, length])
Mid Function Example
MyString = "Mid Function Demo" ' Create text string.
FirstWord = Mid(MyString, 1, 3) ' Returns "Mid".
LastWord = Mid(MyString, 14, 4) ' Returns "Demo".
MidWords = Mid(MyString, 5) ' Returns "Function Demo".
- Len Function
Returns a Variant (Long) containing the number of characters in a string.
Syntax
Len(string)
Len Function Example
MyString = [MyField] ' Initialize variable.
MyLen = Len(MyString)
- InStr Function
Returns a Variant (Long) specifying the position of the first occurrence of one string within another.
Syntax
InStr([start, ]string1, string2[, compare])
InStr Function Example
MyPosition = InStr([address], " ")
- Replace Function
Returns a string in which a specified substring has been replaced with another substring a specified number of times.
Syntax
Replace(expression, find, replace[, start[, count[, compare]]])
Replace Function Example:
NewString = Replace([comments], "#", "!")
- Chr Function
Returns a String containing the character associated with the specified character code. Note: a link to an external ASCII character chart is included in the Related Information section at the bottom of this page.
Syntax
Chr(charcode)
Chr Function Example
' Replace a carriage return character with an exclamation
NewString = Replace([comments], chr(13), "!")
- & Operator
Used to force string concatenation of two expressions.
Syntax
result = expression1 & expression2
& Operator Example
MyStr = [MyField1] & " " & [MyField2]
- If...Then...Else Statement
Conditionally executes a group of statements, depending on the value of an expression.
Syntax
If condition Then [statements] [Else elsestatements]
Or, you can use the block form syntax:
If condition Then
[statements]
[ElseIf condition-n Then
[elseifstatements] ...
[Else
[elsestatements]]
End If
If...Then...Else Statement Example
Number = 53 ' Initialize variable.
If Number < 10 Then
Digits = 1
ElseIf Number < 100 Then
' Condition evaluates to True so the next statement is executed.
Digits = 2
Else
Digits = 3
End If
Below are examples of field calculator expressions that use the above VBA functions, plus many more.
- Concatenate fields in a table.
-show me- Summary Instructions provided describe the necessary steps to concatenate values from two or more fields in a table using ArcMap.Procedure - Start ArcMap
- Add a dataset or stand alone table to ArcMap.
- Right-click the layer or table in the Table of Contents.
- Select the 'Open Attribute Table' or 'Open' option, depending on the data source.
- Select 'Options > Add Field.'
It is possible to use an existing field, but the output of this process will overwrite existing data in that field.
- Define the new field in the 'Add Field' dialog box and click OK.
- Right-click the field name of the new field.
- Select 'Calculate Values.'
- Click 'Yes' to the following prompt:
- Type the following expression, where [Field Name] is the name of each individual field to be concatenated:
[Field Name] & " " & [Field Name] & " " & [Field Name]
This expression adds a space between the values that are being concatenated. For further information on the use of the concatenation operator, see the Microsoft Visual Basic Editor Help files. In ArcMap, select Tools > Macros > Visual Basic Editor. In the Visual Basic Editor, click Help > Microsoft Visual Basic Help. Click the Index tab, type "concatenation operators", and click 'display.' Select '& operator' and click 'display.'
- Click OK.
- Convert a string to proper case.
-show me- Summary Instructions provided describes how to use the ArcMap Field Calculator to convert a string that is upper case, lower case or mixed case to proper case. For example, a string that is in the following formats:
"hello world"
"HELLO WORLD"
"hELLO wORLD"
the VBA function "StrConv" converts the string to: "Hello World".
For information on how to do the equivalent steps in a label expression, please see the link in the Related Information section below.Procedure - Add a new text field to store the new string values.
-show me- - Open the ArcMap field Calculator for the field created in the step above by right-clicking the new field name heading in the Table View and click Calculate Values.
- In the field calculator dialog box, type the following code in the text box under "Your Field Name = "
StrConv([Existing Field], vbProperCase)
Change [Existing Field] to match the name of the existing field that contains the string values that are not currently in proper case. - Click OK in the field calculator dialog box.
- Convert a string to proper case in a label expression
Instructions provided describe how to use a label expression to convert a string that is upper case, lower case or mixed case to proper case. For example, if a string that is in the following formats: "hello world" "HELLO WORLD" "hELLO wOR...
- Add a new text field to store the new string values.
- Round numbers of attribute table to the nearest nth value.
-show me- Summary Instructions provided describe how to round values in an attribute table to the nearest nth value using Field Calculator.Procedure - Open attribute table.
- Right-click field heading and select Calculate Values.
- Place a check in the Advanced checkbox on the field calculator.
- Paste the following code into the Pre-Logic VBA Script Code box.
Dim dblRnd as Double
dblRnd = math.round([Field]/N)*N
- Replace [field] with field to be rounded and N with value to round the values too.
Nearest Half N = 0.5
Nearest Tenth N = 0.1
Nearest Hundredth N = 0.01 - In the final dialog box type "dblRnd" without the quotes.
- Use VBA functions in the field calculator
The field calculator dialog box allows for calculating the values of a field by specifying a calculation expression. You can type the expression directly into the box and also add fields, functions and operators into the box by clicking on them in...
- Create a sequential unique ID field.
-show me- Summary In ArcView 3.x, typing 'rec+1' in the field calculator creates a sequential unique ID field for a layer. Instructions provided describe how to do the equivalent in the ArcMap field calculator.Procedure - Add the number field.
-show me- - Click Start Editing on the Editor toolbar.
- Right-click the new number field. Click Calculate Values.
- Click the Advanced check box.
- Copy the following code into the Pre Logic VBA Script code:
Static rec As Long
Dim pStart As Long
Dim pInterval As Long
' adjust start value if you want it to
' start at a value other than 1.
' For example, 1000.
' ====================================
pStart = 1
' adjust interval value if you want it to
' increment at a value other than 1.
' For example, 2.
' =======================================
pInterval = 1
If (rec = 0) Then
rec = pStart
Else
rec = rec + pInterval
End If
- Type the word 'rec' in the text box under [Your Field Name] =.
- Click OK.
- Add the number field.
- Convert Decimal Degree values to Decimal Minute Seconds.
-show me- Summary Instructions provided describe how to use the Field Calculator to convert Decimal Degrees stored in a Numeric field to Degrees Minutes Seconds stored in a Text field. The output by default will be in the following format:
DDºMM'SS.SS"NProcedure Follow the steps below:- Add the table to ArcMap.
- Right-click on the Table in the Table of Contents and select Open.
- Verify 'Edit' mode is not enabled. Click the Options button and select Add Field.
- Enter DMSLat in the Name field and select Text from the Type drop-down list. If DMSLat is already used as a field name, select a name that is not being used.
- Change the length to 20.
- Right-click on the DMSLat field and select Calculate Values.
- Click Yes, if presented with a message box.
- Check the Advanced check box.
- Paste the following code into the expression box:
Dim DDField
Dim zM1 As Double
Dim Suffix As String
Dim DMS As String
Dim zY As Double
Dim zD As Double, zM As Double, zS As Double
Dim Dchr As String, Mchr As String, Schr As String
Dim Degree As String, Minute As String, Second As String
'=================================================
'Adjust the variables below
DDField = [DDLat] 'Change to field with decimal degree values
Dchr = Chr(186) 'Character after degrees
Mchr = Chr(39) 'Character after minutes
Schr = Chr(34) 'Character after seconds
'=====================================================
zY = DDField
If zY >= 0 Then
Suffix = "N" 'N if Latitude, E if Longitude
Else
Suffix = "S" 'S if Latitude, W if Longitude
End If
zY = Abs(zY)
zD = Int(zY)
Degree = CStr(zD)
zM = (zY - zD) * 60
zM1 = Int(zM)
Minute = CStr(zM1)
zS = FormatNumber(((zM - zM1) * 60), 2)
zS1 = Int(zS)
Second = CStr(zS)
DMS = Degree & Dchr & Minute & Mchr & Second & Schr & Suffix
- Change the value within the brackets next to 'DDField =' to the field in the table that contains the latitude decimal degree values. To change the characters after degrees minutes and seconds edit the value after 'Dchr =', 'Mchr =', and 'Schr =' respectively.
- Paste the following code into the 'DMSLat =' box at the bottom of the dialog box.
DMS
- Click OK to run the Field Calculator.
- Repeat steps 3 through 12 for the longitude values, but change the values within the code where Suffix = "N" to Suffix = "E" and where Suffix = "S" to Suffix = "W". Also, change the value next to 'DDField =' to the field in the table that contains the longitude decimal degree values.
- Convert Degrees Minutes Seconds values to Decimal Degree values using the Field Calculator
Instructions provided describe how to use the Field Calculator to convert Degrees Minutes Seconds stored in a string field to Decimal Degrees stored in a number field. The values must be stored in a field in a table as Degrees Minutes Seconds with...
- Convert Degrees Minutes Seconds values to Decimal Degree values.
-show me- Summary Instructions provided describe how to use the Field Calculator to convert Degrees Minutes Seconds stored in a string field to Decimal Degrees stored in a number field. The values must be stored in a field in a table as Degrees Minutes Seconds with no symbols. For example:
25 35 22.3
In the example, 25 is degrees, 35 is minutes and 22.3 is seconds.Procedure Follow the steps below.
Initially perform the steps below on positive numbers. After the conversion is complete, multiple any fields that need to be negative by -1- Add the table to ArcMap.
- Right-click on the Table in the Table of Contents and select Open.
- Verify 'Edit' mode is not enabled. Click the Options button and select Add Field.
- Enter Lat2 in the Name field and select Double from the Type drop-down list. If Lat2 is already used as a field name, select a name that is not used.
- Verify the Scale and Precision is set to 0 and click OK.
- Right-click on the Lat2 field and select Calculate Values.
- Click Yes if presented with a message box.
- Check the Advanced check box.
- Paste the following code into the expression box:
Dim Degrees as Double
Dim Minutes as Double
Dim Seconds as Double
Dim DMS as Variant
Dim DD as Double
DMS = Split([Latitude])
Degrees = CDbl(DMS(0))
Minutes = CDbl(DMS(1))
Seconds = CDbl(DMS(2))
DD = (Seconds/3600) + (Minutes/60)+ Degrees
- Find the line that begins 'DMS. . .' The text within the brackets [ ] is the name of the field holding the latitude values. Replace the word Latitude in the code with the name of the field that stores the latitude values in the table.
- Paste the following code into the 'Lat2 =' box at the bottom of the dialog box.
CDbl(DD)
- Click OK.
- Repeat steps 3 through 12 for the longitude values.
- Convert Decimal Minutes to Decimal Degrees.
-show me- Summary Instructions provided describe how to convert decimal minutes data to decimal degrees (DDEG) data. This script works for string decimal minutes values in the format of: <Deg> <space> <Decimal_minutes>.
For example:-10 30.57
100 49.3
0 25.2789
45 0
-2 0.25Procedure - Create a new field with type double to store the DDEG data.
-show me- - Select Editor > Start Editing from the Editor toolbar.
- Right-click on the new field and select Calculate Values.
- Click the Advanced check box.
- Copy the following code into the Pre-Logic VBA Script code:
dec_min=[dec_min]
if IsNull(dec_min) or dec_min = "" or IsEmpty(dec_min) then
dec_deg = 0
else
space_pos=InStr(dec_min," ")
deg=Left(dec_min,space_pos-1)
min=Right(dec_min,Len(dec_min)-space_pos)
min=min/60
if deg < 0 then
dec_deg=(Abs(deg)+min) * -1
else
dec_deg=deg+min
end if
end if
- On line 1 of the code sample, change [dec_min] to be the name of the field that stores the decimal minutes values.
- Type the word 'dec_deg' in the text box under [Your field Name] =.
- Click OK.
- Create a new field with type double to store the DDEG data.
- Replace one value for another within a field.
-show me- Summary Instructions provided demonstrate how to use the Replace function in the Field Calculator, to replace one value for another within a field in a table.Procedure - Load the table into ArcMap.
- Select Start Editing from the Editor menu.
- Open the table.
- Right-click the desired field.
- Select Field Calculator.
- Type the following in the expression box:
replace()
- Place the cursor between the parenthesis of the line just typed.
- Select the name of the field from the Fields list.
- Type a comma after the end bracket surrounding the field name.
- Type the value to be replaced and the replacement value; enclose each value in quotation marks and separate with a comma. For example:
replace([FLD_name],"Wisconsin","WI")
- Click OK.
- Truncate a field.
-show me- Summary The ArcMap Field Calculator allows truncating an existing value. Several Visual Basic string manipulation functions are available for truncating values.
The example provided in this article uses the Visual Basic Left function to return a specified number of characters from the left side of a string, and truncates after that number.Procedure - Right-click the layer in the ArcMap table of contents.
- Select Open Attribute Table.
- Select Add Field from the Options dropdown list.
- Create a new text field.
- Start editing.
- Right-click the new field name in the attribute table window.
- Click Field Calculator.
- Insert the following code in the expression box:
Left( [field_name],#)
where [field_name] is the field to truncate and # is the number of characters you want to preserve.
- Populate a date field with unique values.
-show me- Summary Instructions provided describe how to generate unique date values after adding a new date field to an attribute table.Procedure - Start ArcMap.
- Right-click on a layer and Select 'Open Attribute Table.'
- Select 'Options > Add Field'. Name the field.
- Select 'Date' from the 'type' menu. Click OK.
- Right-click on the date field.
- Select 'Calculate Values'.
- Select the 'Date' radio button in the Field Calculator dialog box.
- Copy the code below into the text box.
DateValue("mm/dd/yyyy")
orDateValue("February 11, 2002")
- Click OK.
- Calculate a date field to be the current date.
-show me- Summary Instructions provided describe how to calculate a date field to the current date using ArcMap.Procedure - Open the attribute table that contains the date field.
- Right-click the date field and select Calculate Values.
- If you are comfortable calculating values outside of an edit session click Yes.
- From within the Field Calculator dialog box set the Type radio button to 'Date'.
- Set the field calculator equal to:
NOW()
- Click OK on the field calculator to perform the calculation.
Related Information
Created: 9/15/2006
Last Modified: 11/30/2009