The CROP_AREAS_TO_LINES tool crops or splits areas based on line features. It uses the following parameters:
- AREA_FILENAME - filename of the layer that contains the area features to be cropped. If an empty value is passed in, all loaded area features that meet the AREA_COMPARE_STR conditions will be used. When running the script in the context of the main map view you can also pass in the value 'USER CREATED FEATURES' to have the 'User Created Features' layer updated or 'SELECTED LAYERS' to have any layers selected in the Control Center.
- AREA_COMPARE_STR - specifies a comparison operation to perform to see if an area feature is one that needs to be cropped. The format is attr_name=attr_value or attr_name!=attr_value (for equals and not equals comparisons respectively). For example if you have an attribute named CFCC and you want to match when the value of that attribute starts with an 'A', you can use COMPARE_STR="CFCC=A*" as your parameter. You can add multiple AREA_COMPARE_STR parameters to a single command to combine multiple criteria for your search. If you would like to compare against a feature label rather than an attribute, use <Feature Name> for your attribute name. To compare against a feature type name rather than an attribute, use <Feature Type> for your attribute name. To compare against the feature description, use <Feature Desc> for your attribute name. If you just want all lines features from the specified layer(s), just don't specify a COMPARE_STR value. You can also use <Feature Layer Name> to specify a match against a layer name that will support wildcards.
- LIST_FILENAME - filename of the layer that contains the line features that will be used to crop the area features. If an empty value is passed in, all loaded line features that meet the LINE_COMPARE_STR conditions will be used. When running the script in the context of the main map view you can also pass in the value 'USER CREATED FEATURES' to have the 'User Created Features' layer updated or 'SELECTED LAYERS' to have any layers selected in the Control Center.
- LINE_COMPARE_STR - specifies a comparison operation to perform to see if a line feature is one that will be used to crop the areas. The format is attr_name=attr_value or attr_name!=attr_value (for equals and not equals comparisons respectively). For example if you have an attribute named CFCC and you want to match when the value of that attribute starts with an 'A', you can use COMPARE_STR="CFCC=A*" as your parameter. You can add multiple AREA_COMPARE_STR parameters to a single command to combine multiple criteria for your search. If you would like to compare against a feature label rather than an attribute, use <Feature Name> for your attribute name. To compare against a feature type name rather than an attribute, use <Feature Type> for your attribute name. To compare against the feature description, use <Feature Desc> for your attribute name. If you just want all lines features from the specified layer(s), just don't specify a COMPARE_STR value. You can also use <Feature Layer Name> to specify a match against a layer name that will support wildcards.