Parse Path (ModelBuilder)

Summary

Parses an input into its file name, extension, path, and the last workspace name. The output can be used as an inline variable in the output name of other tools.

Learn how Parse Path works in ModelBuilder

Usage

• This tool is only available from ModelBuilder for use in models. The tool is not available from the Geoprocessing pane or from Python.

• More than one variable name can be added to create unique names for the output, for example, C:\Temp\Out_%Name%_%Workspace Name%.

• If the input to this tool is C:\1Tool Data\City Roads.shp, for example, it will be parsed into the following outputs:

  Parse	Result
  Path	C:\1Tool Data
  Name	City Roads
  Extension	shp
  Workspace Name	1Tool Data

  If the Format The name, extension and workspace parameter is checked, the path above will be parsed into the following outputs:

  Parse	Result
  Path	C:\1Tool Data
  Name	City_Roads
  Extension	shp
  Workspace Name	_1Tool_Data

• The same functionality can be accessed in scripting with the Python os module. For example, if you pass the following input variable:

  inData = r"C:\1Tool Data\City Roads.shp", then

  • To get the name City Roads
    import os
    name = os.path.basename(inData)

  • To get the path C:\1Tool Data
    import os
    path = os.path.dirname(inData)

  • To get the file extension shp
    import os
    ext = os.path.splitext(inData)[1][1:]

  • To get the workspace name 1Tool Data
    import os
    folder = os.path.basename(os.path.dirname(inData))

  To parse paths in a similar way to when the Format Name, Extension and Workspace parameter is checked, do the following:

  • To get the name City_Roads
    import os
    import re
    name = os.path.basename(inData)
    name = re.sub('[^0-9a-zA-Z]+', '_', name)
    if name[0].isdigit():
        name = "_" + name

  • To get the path C:\1Tool Data
    import os
    path = os.path.dirname(inData)

  • To get the file extension shp
    import os
    ext = os.path.splitext(inData)[1][1:]

  • To get the workspace name _1Tool_Data
    import os
    import re
    folder = os.path.basename(os.path.dirname(inData))
    folder = re.sub('[^0-9a-zA-Z]+', '_', folder)
    if folder[0].isdigit():
        folder = "_" + folder

• The Path output of this tool has a workspace data type and can be connected directly as an input to the Create Feature Class tool's Feature Class Location parameter, which accepts a workspace data type as input. For tools such as Copy that do not have a workspace data type parameter, the Path value can be passed to the tool using inline variable substitution such as %Path%\Out_%Name%.%Extension%.

  

Parameters

Dialog

Label	Explanation	Data Type
Input Values	The input values that will be parsed.	Any Value
Format the name, extension and workspace (Optional)	Specifies whether all reserved characters will be removed. Checked—Reserved characters will be removed. Unchecked—Reserved characters will not be removed. This is the default.	Boolean

Derived Output

Label	Explanation	Data Type
Path	The workspace of the input.	Workspace
Name	The file name, excluding the extension.	String
Extension	The file extension.	String
Workspace Name	The name of the workspace.	String

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes