<?xml version="1.0" encoding="UTF-8"?><metadata>
<Esri>
<CreaDate>20181128</CreaDate>
<CreaTime>13032200</CreaTime>
<ArcGISFormat>1.0</ArcGISFormat>
<SyncOnce>TRUE</SyncOnce>
<ModDate>20190808</ModDate>
<ModTime>091316</ModTime>
</Esri>
<dataIdInfo>
<idCitation>
<resTitle>Summarize Within</resTitle>
<date>
<createDate>20181128</createDate>
</date>
</idCitation>
<idAbs>
<para>Overlays a polygon layer with another layer to summarize the number of points, length of the lines, or area of the polygons within each polygon, and calculate attribute field statistics about those features within the polygons.</para>
<para>
Example scenarios using Summarize Within:
<bulletList>
<bullet_item>Given a layer of watershed boundaries and a layer of land-use boundaries by land-use type, calculate total acreage of land-use type for each watershed.</bullet_item>
<bullet_item>Given a layer of parcels in a county and a layer of city boundaries, summarize the average value of vacant parcels within each city boundary.</bullet_item>
<bullet_item>Given a layer of counties and a layer of roads, summarize the total mileage of roads by road type within each county.</bullet_item>
</bulletList>
</para>
</idAbs>
<descKeys KeyTypCd="005">
<keyTyp>
<keyTyp>005</keyTyp>
</keyTyp>
<keyword/>
<keyword>Count</keyword>
<keyword>Inside</keyword>
<keyword>Overlap</keyword>
<keyword>Overlay</keyword>
<keyword>Polygon</keyword>
<keyword>Sum</keyword>
<keyword>Summary</keyword>
</descKeys>
</dataIdInfo>
<distInfo>
<distributor>
<distorFormat>
<formatName>ArcToolbox Tool</formatName>
</distorFormat>
</distributor>
</distInfo>
<mdDateSt>20181128</mdDateSt>
<mdContact>
<rpOrgName>Environmental Systems Research Institute, Inc. (Esri)</rpOrgName>
<rpCntInfo>
<cntAddress>
<delPoint>380 New York Street</delPoint>
<city>Redlands</city>
<adminArea>California</adminArea>
<postCode>92373-8100</postCode>
<eMailAdd>info@esri.com</eMailAdd>
<country>United States</country>
</cntAddress>
<cntPhone>
<voiceNum>909-793-2853</voiceNum>
<faxNum>909-793-5953</faxNum>
</cntPhone>
<cntOnlineRes>
<linkage>http://www.esri.com</linkage>
</cntOnlineRes>
</rpCntInfo>
<role>
<RoleCd>007</RoleCd>
</role>
</mdContact>
<tool displayname="Summarize Within" name="SummarizeWithin" softwarerestriction="none" toolboxalias="&lt;process id=&quot;Background#3:258247150109016&quot; ticks=&quot;637008630060000000&quot; err_code=&quot;0&quot; has_error=&quot;false&quot; decimal_point=&quot;,&quot; version=&quot;1&quot; ticks2=&quot;637008630181014130&quot;&gt; &lt;tool name=&quot;SummarizeWithin&quot; type=&quot;script&quot; toolboxalias=&quot;analysis&quot;&gt; &lt;displayname&gt;Summarize Within&lt;/displayname&gt; &lt;description&gt;Geoprocessing tool that overlays a polygon layer with another layer to summarize the number of points, length of the lines, or area of the polygons within each polygon, and calculate attribute field statistics about those features within the polygons.&lt;/description&gt; &lt;/tool&gt; &lt;params&gt; &lt;param name=&quot;in_polygons&quot; displayname=&quot;Input Polygons&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPFeatureLayer&quot;&gt;ROUBO_FURTO_Dissolve&lt;/param&gt; &lt;param name=&quot;in_sum_features&quot; displayname=&quot;Input Summary Features&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPFeatureLayer&quot;&gt;ROUBO_FURTO_Dissolve&lt;/param&gt; &lt;param name=&quot;out_feature_class&quot; displayname=&quot;Output Feature Class&quot; derived=&quot;false&quot; output=&quot;true&quot; datatype=&quot;DEFeatureClass&quot;&gt;C:\Users\giovani\Documents\ArcGIS\Projects\app3 light\app3 light.gdb\ROUBO_FURTO_SummarizeWithin&lt;/param&gt; &lt;param name=&quot;keep_all_polygons&quot; displayname=&quot;Keep all input polygons&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPBoolean&quot;&gt;ONLY_INTERSECTING&lt;/param&gt; &lt;param name=&quot;sum_fields&quot; displayname=&quot;Summary Fields&quot; derived=&quot;false&quot; output=&quot;false&quot; subDType=&quot;Field;GPString&quot; datatype=&quot;GPValueTable&quot;&gt;Shape_Area Sum&lt;/param&gt; &lt;param name=&quot;sum_shape&quot; displayname=&quot;Add shape summary attributes&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPBoolean&quot;&gt;ADD_SHAPE_SUM&lt;/param&gt; &lt;param name=&quot;shape_unit&quot; displayname=&quot;Shape Unit&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPString&quot;&gt;HECTARES&lt;/param&gt; &lt;param name=&quot;group_field&quot; displayname=&quot;Group Field&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;Field&quot;&gt;&lt;/param&gt; &lt;param name=&quot;add_min_maj&quot; displayname=&quot;Add minority and majority attributes&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPBoolean&quot;&gt;NO_MIN_MAJ&lt;/param&gt; &lt;param name=&quot;add_group_percent&quot; displayname=&quot;Add group percentages&quot; derived=&quot;false&quot; output=&quot;false&quot; datatype=&quot;GPBoolean&quot;&gt;NO_PERCENT&lt;/param&gt; &lt;param name=&quot;out_group_table&quot; displayname=&quot;Output Grouped Table&quot; derived=&quot;false&quot; output=&quot;true&quot; datatype=&quot;DETable&quot;&gt;&lt;/param&gt; &lt;/params&gt; &lt;environments /&gt; &lt;return_value&gt;C:\Users\giovani\Documents\ArcGIS\Projects\app3 light\app3 light.gdb\ROUBO_FURTO_SummarizeWithin; &lt;/return_value&gt; &lt;messages&gt; &lt;msg code=&quot;0&quot; type=&quot;2&quot;&gt;Start Time: quinta-feira, 8 de agosto de 2019 09:10:06&lt;/msg&gt; &lt;msg code=&quot;0&quot; type=&quot;0&quot;&gt;Running script Summarize Within...&lt;/msg&gt; &lt;msg code=&quot;0&quot; type=&quot;0&quot;&gt;Completed script Summarize Within...&lt;/msg&gt; &lt;msg code=&quot;0&quot; type=&quot;3&quot;&gt;Succeeded at quinta-feira, 8 de agosto de 2019 09:10:17 (Elapsed Time: 11,35 seconds)&lt;/msg&gt; &lt;/messages&gt; &lt;/process&gt;">
<summary>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Geoprocessing tool that overlays a polygon layer with another layer to summarize the number of points, length of the lines, or area of the polygons within each polygon, and calculate attribute field statistics about those features within the polygons.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</summary>
<alink_name>
SummarizeWithin_analysis</alink_name>
<toolIllust alt="Summarize Within" src="withheld" type="illustration"/>
<parameters>
<param datatype="Feature Set" direction="Input" displayname="Input Polygons" expression="in_polygons" name="in_polygons" sync="true" type="Required">
<pythonReference>
<para>
The polygons used to summarize the features, or portions of features, in the input summary layer.
</para>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;The polygons used to summarize the features, or portions of features, in the input summary layer.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
<param datatype="Feature Set" direction="Input" displayname="Input Summary Features" expression="in_sum_features" name="in_sum_features" sync="true" type="Required">
<pythonReference>
<para>
The point, line, or polygon features that will be summarized for each polygon in the input polygons.
</para>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;The point, line, or polygon features that will be summarized for each polygon in the input polygons.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
<param datatype="Feature Set" direction="Output" displayname="Output Feature Class" expression="{out_feature_class}" name="out_feature_class" sync="true" type="Optional">
<pythonReference>
<para>
The output polygon feature class containing the same geometries and attributes as the input polygons with additional new attributes about the number points, length of lines, and area of polygons inside each input polygon and statistics about those features.</para>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;The output polygon feature class containing the same geometries and attributes as the input polygons with additional new attributes about the number points, length of lines, and area of polygons inside each input polygon and statistics about those features.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
<param datatype="Boolean" direction="Input" displayname="Keep all input polygons" expression="{keep_all_polygons}" name="keep_all_polygons" sync="true" type="Optional">
<pythonReference>
<para>
Determines if all input polygons or only those containing at least one input point will be copied to the output feature class.</para>
<bulletList>
<bullet_item>KEEP_ALL—All input polygons will be copied to the output feature class. This is the default.</bullet_item>
<bullet_item>ONLY_INTERSECTING—Only input polygons that intersect or contain at least one input summary feature will be copied to the output feature class.</bullet_item>
</bulletList>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Determines if all input polygons or only those intersecting or containing at least one input summary feature will be copied to the output feature class.Checked—All input polygons will be copied to the output feature class. This is the default.Unchecked—Only input polygons that intersect or contain at least one input summary feature will be copied to the output feature class.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="Shape Unit" expression="{HECTARES | ACRES | SQUAREMETERS | SQUAREKILOMETERS}" name="shape_unit" sync="true" type="Optional">
<pythonReference>
<para>
The unit in which to calculate shape summary
attributes. If the input summary features are points no shape unit is necessary, since only the count of points within each input polygon is added.</para>
<para/>
<para>If the input summary features are lines, specify a linear unit. If the input summary features are polygons, specify an areal unit.</para>
<bulletList>
<bullet_item>METERS—Meters</bullet_item>
<bullet_item>KILOMETERS—Kilometers</bullet_item>
<bullet_item>FEET—Feet</bullet_item>
<bullet_item>YARDS—Yards</bullet_item>
<bullet_item>MILES—Miles</bullet_item>
<bullet_item>ACRES—Acres</bullet_item>
<bullet_item>HECTARES—Hectares</bullet_item>
<bullet_item>SQUAREMETERS—Square meters</bullet_item>
<bullet_item>SQUAREKILOMETERS—Square kilometers</bullet_item>
<bullet_item>SQUAREFEET—Square feet</bullet_item>
<bullet_item>SQUAREYARDS—Square yards</bullet_item>
<bullet_item>SQUAREMILES—Square miles</bullet_item>
</bulletList>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;The unit in which to calculate shape summary
attributes. If the input summary features are points no shape unit is necessary, since only the count of points within each input polygon is added.If the input summary features are lines, specify a linear unit. If the input summary features are polygons, specify an areal unit.Meters—MetersKilometers—KilometersFeet—FeetYards—YardsMiles—MilesAcres—AcresHectares—HectaresSquare meters—Square metersSquare kilometers—Square kilometersSquare feet—Square feetSquare yards—Square yardsSquare miles—Square miles&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
<enumcorrespondence>
<enum label="Meters" name="METERS"/>
<enum label="Kilometers" name="KILOMETERS"/>
<enum label="Feet" name="FEET"/>
<enum label="Yards" name="YARDS"/>
<enum label="Miles" name="MILES"/>
<enum label="Acres" name="ACRES"/>
<enum label="Hectares" name="HECTARES"/>
<enum label="Square meters" name="SQUAREMETERS"/>
<enum label="Square kilometers" name="SQUAREKILOMETERS"/>
<enum label="Square feet" name="SQUAREFEET"/>
<enum label="Square yards" name="SQUAREYARDS"/>
<enum label="Square miles" name="SQUAREMILES"/>
</enumcorrespondence>
</param>
<param datatype="String" direction="Input" displayname="Group Field" expression="{nm_municip | Shape_Length | Shape_Area}" name="group_field" sync="true" type="Optional">
<pythonReference>
<para>Attribute field from the input summary features that is used for grouping. Features that have the same group field value will be combined and summarized with other features with the same group field value.</para>
<para>When you chose a group field, an additional output grouped table will be created and its location must be specified in the out_grouped_table parameter. </para>
</pythonReference>
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;Attribute field from the input summary features that is used for grouping. Features that have the same group field value will be combined and summarized with other features with the same group field value.When you chose a group field, an additional output grouped table will be created and its location must be specified. This output grouped table is required when using a group field.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="Output Feature Service Name" expression="{esri_out_feature_service_name}" name="esri_out_feature_service_name" type="Optional">
<dialogReference>&lt;DIV STYLE="text-align:Left;"&gt;&lt;DIV&gt;&lt;P&gt;&lt;SPAN&gt;The name of the optional feature service to create on the federated server containing the result of this tool. If no name is specified an output feature service will not be created.&lt;/SPAN&gt;&lt;/P&gt;&lt;/DIV&gt;&lt;/DIV&gt;</dialogReference>
</param>
</parameters>
<returnvalues/>
<environments>
<environment label="Output coordinate system" name="outputCoordinateSystem">
</environment>
<environment label="Output extent" name="extent"/>
<environment label="Current workspace" name="workspace"/>
<environment label="Scratch workspace" name="scratchWorkspace"/>
<environment label="Output has Z values" name="outputZFlag"/>
<environment label="Z resolution" name="ZResolution"/>
<environment label="Default output Z value" name="outputZValue"/>
<environment label="Geograpic transformations" name="geographicTransformations"/>
<environment label="Output XY domain" name="XYDomain"/>
<environment label="Output Z domain" name="ZDomain"/>
<environment label="XY resolution" name="XYResolution"/>
<environment label="XY tolerance" name="XYTolerance"/>
<environment label="Z tolerance" name="ZTolerance"/>
</environments>
<usage>
<bullet_item>
<para>You can think of Summarize Within as taking two
layers, the input polygons and the input summary features, and stacking them on top of each other. After stacking these layers, you peer down through the stack and count the number input summary features that fall within the input polygons. Not only can you count the number of features, you can calculate simple statistics about the attributes of the input summary features, such as sum, mean, minimum, maximum, and so on.</para>
</bullet_item>
<bullet_item>
<para>The Summarize Within and Summarize Nearby tools are conceptually the same. With the Summarize Within tool you can summarize features within existing polygons, whereas with the Summarize Nearby tool you can generate areas around points, lines, or polygons, and summarize features within those derived areas.</para>
</bullet_item>
<bullet_item>
<para>You can create groups by specifying a group field from the input points. For example, if you are
summarizing crimes within neighborhood boundaries, you may have an
attribute Crime_type with five different crime types. Each unique crime type
forms a group, and the statistics you choose will be calculated for
each unique value of Crime_type.</para>
</bullet_item>
</usage>
<scriptExamples>
<scriptExample>
<title>SummarizeWithin example 1 (Python window)</title>
<para>The following Python window script demonstrates how to use the SummarizeWithin function.</para>
<code xml:space="preserve">import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.SummarizeWithin_analysis('neighborhoods', 'crimes', 'neighborhood_crimes')
</code>
</scriptExample>
<scriptExample>
<title>SummarizeWithin example 2 (stand-alone script)</title>
<para>The following standalone script is an example of how to use the SummarizeWithin function in a scripting environment.</para>
<code xml:space="preserve"># Description: Use SummarizeWithin to summarize the crimes in each city neighborhood
# import system modules import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data/city.gdb'
# Set local variables
polys = 'neighborhoods'
points = 'crimes'
outFeatureClass = 'crimes_aggregated'
keepAll = 'KEEP_ALL'
sumFields = [['Damages', 'SUM'], ['VICTIM_AGE', 'MEAN']]
addShapeSum = 'ADD_SHAPE_SUM'
groupField = 'Crime_type'
addMinMaj = 'ADD_MIN_MAJ'
addPercents = 'ADD_PERCENT'
outTable = 'crimes_aggregated_groups'
arcpy.SummarizeWithin_analysis(polys, points, outFeatureClass, keepAll, sumFields, addShapeSum, '', groupField, addMinMaj, addPercents, outTable)
</code>
</scriptExample>
</scriptExamples>
<shortdesc>
ArcGIS geoprocessing tool that overlays a polygon layer with another layer to summarize the number of points, length of the lines, or area of the polygons within each polygon, and calculate attribute field statistics about those features within the polygons. </shortdesc>
<arcToolboxHelpPath>withheld</arcToolboxHelpPath>
</tool>
</metadata>
