root/MGET/Branches/Jason/PythonPackage/dist/TracOnlineDocumentation/Documentation/PythonReference/Method_GeoEco.DataManagement.Files.File.FindAndCreateArcGISTable.html @ 316

Revision 316, 28.3 KB (checked in by jjr8, 5 years ago)

Built MGET 0.7a1. Forgot to mention that the checkin before the last one also fixed #308: When a GAM uses the loess function (lo) and is fitted with the R gam package, Predict GAM fails when rasters include NODATA values.

This will be merged into Trunk and released as MGET 0.7a1.
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>FindAndCreateArcGISTable Method</title><link rel="stylesheet" type="text/css" href="lib.css?format=raw" /><style xml:space="preserve">
4            td.metadataTitle { font-size: 80%; font-weight: bold; font-family: avantgarde, sans-serif; }
5            td.metadataValue { padding-left: 0.5em; }
6          </style></head><body><div class="navigation"><div><table align="center" width="100%" cellpadding="0" cellspacing="2"><tr><td class="online-navigation"><a title="FindAndCopy Method" href="Method_GeoEco.DataManagement.Files.File.FindAndCopy.html?format=raw"><img src="previous.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Previous Page" /></a></td><td class="online-navigation"><a title="File Class" href="Class_GeoEco.DataManagement.Files.File.html?format=raw"><img src="up.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Up one Level" /></a></td><td class="online-navigation"><a title="FindAndCreateTable Method" href="Method_GeoEco.DataManagement.Files.File.FindAndCreateTable.html?format=raw"><img src="next.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Next Page" /></a></td><td align="center" width="100%">GeoEco Python Reference</td><td class="online-navigation"><a title="Table of Contents" href="TableOfContents.html?format=raw"><img src="contents.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Table of Contents" /></a></td><td class="online-navigation"><a title="Module Index" href="ModuleIndex.html?format=raw"><img src="modules.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Module Index" /></a></td><td class="online-navigation"><img src="blank.png?format=raw" border="0" align="bottom" height="32" width="32" alt="" /></td></tr></table><div class="online-navigation"><b class="navlabel">Previous:</b> <a class="sectref" href="Method_GeoEco.DataManagement.Files.File.FindAndCopy.html?format=raw">FindAndCopy Method</a> <b class="navlabel">Up:</b> <a class="sectref" href="Class_GeoEco.DataManagement.Files.File.html?format=raw">File Class</a> <b class="navlabel">Next:</b> <a class="sectref" href="Method_GeoEco.DataManagement.Files.File.FindAndCreateTable.html?format=raw">FindAndCreateTable Method</a> </div><hr /></div></div><h1><tt class="member">FindAndCreateArcGISTable</tt> Method</h1><p>Finds files within a directory and creates a table that lists them.</p><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td class="metadataTitle">Class:</td><td class="metadataValue"><tt class="class"><a href="Class_GeoEco.DataManagement.Files.File.html?format=raw">File</a></tt></td></tr><tr valign="baseline"><td class="metadataTitle">Intended use:</td><td class="metadataValue">Recommended for external callers</td></tr><tr valign="baseline"><td class="metadataTitle">COM:</td><td class="metadataValue">Exposed as the <a style="font-family: verdana, sans serif; font-size: small;" href="../COMReference/Method_GeoEco.File.FindAndCreateArcGISTable.html?format=raw">FindAndCreateArcGISTable</a> method of COM class <a style="font-family: verdana, sans serif; font-size: small;" href="../COMReference/Class_GeoEco.File.html?format=raw">GeoEco.File</a></td></tr><tr valign="baseline"><td class="metadataTitle">ArcGIS:</td><td class="metadataValue">Exposed as the <a style="font-family: verdana, sans serif; font-size: small;" href="../ArcGISReference/File.FindAndCreateArcGISTable.html?format=raw">Find Files</a> geoprocessing tool</td></tr><tr valign="baseline"><td class="metadataTitle">Method type:</td><td class="metadataValue">Classmethod</td></tr></table><h3>Usage</h3><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td style="white-space: nowrap;"><var>createdTable</var> = <b><tt class="method">File.FindAndCreateArcGISTable</tt></b>(</td><td><var>directory</var><var>, workspace</var><var>, table</var><var>, fileField</var><big>[</big><var>, wildcard</var><big>[</big><var>, searchTree</var><big>[</big><var>, minSize</var><big>[</big><var>, maxSize</var><big>[</big><var>, minDateCreated</var><big>[</big><var>, maxDateCreated</var><big>[</big><var>, minDateModified</var><big>[</big><var>, maxDateModified</var><big>[</big><var>, relativePathField</var><big>[</big><var>, sizeField</var><big>[</big><var>, dateCreatedField</var><big>[</big><var>, dateModifiedField</var><big>[</big><var>, parsedDateField</var><big>[</big><var>, dateParsingExpression</var><big>[</big><var>, unixTimeField</var><big>[</big><var>, maxPathLength</var><big>[</big><var>, overwriteExisting</var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var><big>]</big><var></var>)</td></tr></table><h3>Arguments</h3><dl><dt><var>directory</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr><tr valign="baseline"><td class="metadataTitle">Maximum length:</td><td class="metadataValue">255</td></tr><tr valign="baseline"><td class="metadataTitle">Must exist:</td><td class="metadataValue">Yes</td></tr></table><p>Directory to search.</p></dd></dl><dl><dt><var>workspace</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr><tr valign="baseline"><td class="metadataTitle">Maximum length:</td><td class="metadataValue">255</td></tr><tr valign="baseline"><td class="metadataTitle">Must exist:</td><td class="metadataValue">Yes</td></tr></table><p>Workspace in which the table should be created.</p></dd></dl><dl><dt><var>table</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the table to create.</p><p>If the output workspace is a directory (rather than a database) a
7dBASE table will be created. It is not possible to create other types
8of tables in the file system (e.g. comma or space-delimited text
9files). This restriction is imposed by the ArcGIS CreateTable tool,
10which is used to create the table. If you omit an extension from the
11table name, .dbf will be added automatically. If you specify another
12extension, such as .csv or .txt, it will be replaced with .dbf.</p></dd></dl><dl><dt><var>fileField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive absolute paths to the files that were
13found.</p></dd></dl><dl><dt><var>wildcard</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><code>u'*'</code></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>UNIX-style "glob" wildcard expression specifying the pathnames to
14find.</p><p>The glob syntax supports the following patterns:</p><ul><li>? - matches any single character</li><li>* - matches zero or more characters</li><li>[seq] - matches any single character in <em>seq</em></li><li>[!seq] - matches any single character not in <em>seq</em></li></ul><p><em>seq</em> is one or more characters, such as abc. You may specify
15character ranges using a dash. For example, a-z0-9 specifies all of
16the characters in the English alphabet and the decimal digits 0
17through 9.</p><p>You may specify subdirectories in the glob expression. For example,
18the expression cruise*/sst* will find all paths beginning with sst
19that are contained in directories beginning with cruise.</p><p>The operating system determines whether / or \ is used as the
20directory separator. On Windows, both will work. On most flavors of
21UNIX, / must be used.</p><p>The operating system determines if matching is case sensitive. On
22Windows, matching is case-insensitive. On most flavors of UNIX,
23matching is case-sensitive.</p></dd></dl><dl><dt><var>searchTree</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">bool</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><code>False</code></td></tr></table><p>If True, subdirectories will be searched.</p></dd></dl><dl><dt><var>minSize</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">int</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum value:</td><td class="metadataValue"><code>0</code></td></tr></table><p>Minimum size, in bytes, of files to find. If provided, only files
24that are this size or larger will be found.</p></dd></dl><dl><dt><var>maxSize</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">int</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum value:</td><td class="metadataValue"><code>0</code></td></tr></table><p>Maximum size, in bytes, of files to find. If provided, only files
25that are this size or smaller will be found.</p></dd></dl><dl><dt><var>minDateCreated</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">datetime.datetime</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr></table><p>Minimum creation date, in the local time zone, of the files to
26find, as reported by the operating system. If provided, only files
27that were created on or after this date will be found. You may provide
28a date with or without a time. If you do not provide a time, it is
29assumed to be midnight.</p></dd></dl><dl><dt><var>maxDateCreated</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">datetime.datetime</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr></table><p>Maximum creation date, in the local time zone, of the files to
30find, as reported by the operating system. If provided, only files
31that were created on or before this date will be found. You may
32provide a date with or without a time. If you do not provide a time,
33it is assumed to be midnight.</p></dd></dl><dl><dt><var>minDateModified</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">datetime.datetime</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr></table><p>Minimum modification date, in the local time zone, of the files to
34find, as reported by the operating system. If provided, only files
35that were modified on or after this date will be found. You may
36provide a date with or without a time. If you do not provide a time,
37it is assumed to be midnight.</p></dd></dl><dl><dt><var>maxDateModified</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">datetime.datetime</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr></table><p>Maximum modification date, in the local time zone, of the files to
38find, as reported by the operating system. If provided, only files
39that were modified on or before this date will be found. You may
40provide a date with or without a time. If you do not provide a time,
41it is assumed to be midnight.</p></dd></dl><dl><dt><var>relativePathField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive paths of the files that were found,
42relative to the output table. For example, if the path to the table is:</p><div class="verbatim"><pre xml:space="preserve">C:\Data\Files\FoundFiles.dbf</pre></div><p>the relative paths for the files:</p><div class="verbatim"><pre xml:space="preserve">C:\Data\Files\Group1\f1
43C:\Data\Files\f1
44C:\Data\f1
45C:\f1
46D:\f1
47\\MyServer\Data\f1</pre></div><p>would be:</p><div class="verbatim"><pre xml:space="preserve">Group1\f1
48f1
49..\f1
50..\..\f1
51D:\f1
52\\MyServer\Data\f1</pre></div><p>If the table is in a personal geodatabase:</p><div class="verbatim"><pre xml:space="preserve">C:\Data\Files\FileInfo.mdb\FoundFiles</pre></div><p>the relative paths would be:</p><div class="verbatim"><pre xml:space="preserve">..\Group1\f1
53..\f1
54..\..\f1
55..\..\..\f1
56D:\f1
57\\MyServer\Data\f1</pre></div></dd></dl><dl><dt><var>sizeField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive the sizes of the files that were
58found.</p></dd></dl><dl><dt><var>dateCreatedField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive the creation dates of the files that
59were found.</p></dd></dl><dl><dt><var>dateModifiedField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive the modification dates of the files
60that were found.</p></dd></dl><dl><dt><var>parsedDateField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive dates parsed from the paths of the
61files that were found. You must also specify a date parsing
62expression.</p></dd></dl><dl><dt><var>dateParsingExpression</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Expression for parsing dates from the paths of the files that were
63found. The expression will be ignored if you do not also specify a
64field to receive the dates or the equivalent UNIX time.</p><p>The expression is a standard <a href="http://docs.python.org/lib/re-syntax.html">Python regular expression</a> with additional codes
65for matching fragments of dates:</p><div class="verbatim"><pre xml:space="preserve">%d - Day of the month as a decimal number (range: 01 to 31)
66%H - Hour (24-hour clock) as a decimal number (range: 00 to 23)
67%j - Day of the year as a decimal number (range: 001 to 366)
68%m - Month as a decimal number (range: 01 to 12)
69%M - Minute as a decimal number (range: 00 to 59)
70%S - Second as a decimal number (range: 00 to 61)
71%y - Year without century as a decimal number (range: 00 to 99)
72%Y - Year with century as a decimal number (range: 0001 to 9999)
73%% - A literal "%" character</pre></div><p>A date is parsed from a path as follows:</p><ol><li>The date fragment codes in your expression are replaced by regular
74expression groups to produce a true regular expression. For
75example, if your expression is "%Y_%m_%d", it is converted to the
76regular expression
77"(\d\d\d\d)_(\d\d)_(\d\d)".</li><li>The Python re.search function is invoked to find the
78first occurrence of the regular expression in the path. The
79search proceeds from left to right.</li><li>If an occurrence is found, the regular expression groups are
80extracted and the Python time.strptime function is invoked to parse
81a date from the groups.</li></ol><p>Notes:</p><ul><li>Your expression must include at least one date fragment code, but it
82need not include all of them. If a particular code is missing, the
83following default values will be used: year 1900, month 01, day 01,
84hour 00, minute 00, second 00.</li><li>You cannot specify a given date fragment code more than once.</li><li>You cannot specify date fragment codes that might conflict. For
85example, you cannot specify both %j and %d because this could result
86in conflicting values for the day.</li><li>For %y, values 00 to 68 are interpreted as years 2000 through 2068,
87while 69 through 99 are interpreted as years 1969 through 1999.</li><li>Remember that the entire path is searched for your expression, from
88left to right. The first occurrence of it may be in the parent
89directories.</li><li>The date fragment codes are case-sensitive.</li><li>If the underlying database table can hold the time as well as the
90date in a single field, the time will be stored along with the date.
91These databases include Microsoft Access, Microsoft SQL Server, and
92Oracle, among others. If the table cannot hold the time and date in
93a single field, then only the date will be stored. This is the case,
94for example, with dBASE III and IV tables (.dbf files), often used
95by ArcGIS.</li><li>The timezone of the parsed date is assumed to be UTC.</li></ul><p>Examples:</p><p>The expression:</p><div class="verbatim"><pre xml:space="preserve">%Y%j</pre></div><p>will parse dates from many popular oceanographic satellite data
96products, such as:</p><div class="verbatim"><pre xml:space="preserve">A2007006.L3b_DAY.main.bz2           MODIS Aqua from NASA OceanColor
97S1997247.L3b_DAY.main.bz2           SeaWiFS from NASA OceanColor
981990182.s04d1pfv50-sst-16b.hdf      AVHRR Pathfinder version 5.0 SST from NOAA NODC
99QS_XWGRD3_2003033.20070991747.gz    QuikSCAT winds from NASA JPL PO.DAAC</pre></div><p>The expression:</p><div class="verbatim"><pre xml:space="preserve">%Y_%j_%H</pre></div><p>will parse dates from the hourly and 3-hour GOES SST products offered
100by NASA JPL PO.DAAC:</p><div class="verbatim"><pre xml:space="preserve">sst1_2005_033_17.gz                 An hourly GOES SST file
101sst3_2005_033_06.gz                 A 3-hour GOES SST file</pre></div><p>The expression:</p><div class="verbatim"><pre xml:space="preserve">%Y_%j_%H%M</pre></div><p>will parse dates from the CoastWatch AVHRR SST product offered in HDF
102format by NOAA CLASS (the CW_REGION product). Note that this product
103includes the hour and minute of the satellite pass:</p><div class="verbatim"><pre xml:space="preserve">2007_207_2214_n15_sr.hdf            A CoastWatch AVHRR file</pre></div></dd></dl><dl><dt><var>unixTimeField</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr></table><p>Name of the field to receive dates, in "UNIX time" format, parsed
104from the paths of the files that were found. You must also specify a
105date parsing expression.</p><p>UNIX times are 32-bit signed integers that are the number of seconds
106since 1970-01-01 00:00:00 UTC. This tool assumes the date that was
107parsed is in the UTC timezone. The UNIX time values produced by this
108tool do not include leap seconds; this tool assumes that a regular
109year is 31536000 seconds and a leap year is 31622400 seconds.</p></dd></dl><dl><dt><var>maxPathLength</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">int</tt> or <tt class="class">None</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><code>255</code></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum value:</td><td class="metadataValue"><code>1</code></td></tr></table><p>Maximum length of a path for this operating system. This value is
110used to specify the width of the field that is created. You should
111provide a value only if the underlying database requires that you
112specify a width for string fields. If you provide a value that is too
113small to hold one of the paths that is found, this function will fail
114when it finds that path.</p></dd></dl><dl><dt><var>overwriteExisting</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">bool</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Default value:</td><td class="metadataValue"><code>False</code></td></tr></table><p>If True, the output table will be overwritten, if it exists.</p><p>If False, a ValueError will be raised if the output table exists.</p></dd></dl><h3>Returns</h3><dl><dt><var>createdTable</var></dt><dd><table cellpadding="0" cellspacing="0" style="margin-top: 1.0em;"><tr valign="baseline"><td class="metadataTitle">Python type:</td><td class="metadataValue"><tt class="class">unicode</tt></td></tr><tr valign="baseline"><td class="metadataTitle">Minimum length:</td><td class="metadataValue">1</td></tr><tr valign="baseline"><td class="metadataTitle">Maximum length:</td><td class="metadataValue">255</td></tr><tr valign="baseline"><td class="metadataTitle">Must exist:</td><td class="metadataValue">No</td></tr></table><p>Database table that was created. This string is usually identical
115to the string that was passed in for the table input parameter. But if
116you are creating a table using an ArcGIS91DatabaseConnection, it may
117be different. The circumstances that are known to cause this include:</p><ul><li>If you use ArcGIS to create a dBASE table but do not specify the
118.dbf extension, the ArcGIS geoprocessor automatically adds it for
119you. This is important: even though the geoprocessor's CreateTable
120function will accept a table name without the .dbf extension, other
121geoprocessor functions require it. If possible, you should always
122explicitly specify the .dbf extension. In the cases where you cannot
123(e.g. when you are relying on the ArcGIS UI to enforce it, but it
124does not), you can use this return value.</li><li>If you specify an invalid table name, the ArcGIS geoprocessor will
125try to tweak it into a valid name. For example, if you specify a
126reserved word for the table name (e.g. "select"), ArcGIS may add an
127underscore to it (e.g. "select_").</li></ul></dd></dl><h3>Remarks</h3><p>On Windows, this function makes no distinction between hidden and
128visible directories. Hidden directories are traversed and handled just
129like visible directories.</p><p>Files are returned in an arbitrary order determined by the operating
130system and the search algorithm.</p><div class="navigation"><div class="online-navigation"><p></p><hr /><table align="center" width="100%" cellpadding="0" cellspacing="2"><tr><td class="online-navigation"><a title="FindAndCopy Method" href="Method_GeoEco.DataManagement.Files.File.FindAndCopy.html?format=raw"><img src="previous.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Previous Page" /></a></td><td class="online-navigation"><a title="File Class" href="Class_GeoEco.DataManagement.Files.File.html?format=raw"><img src="up.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Up one Level" /></a></td><td class="online-navigation"><a title="FindAndCreateTable Method" href="Method_GeoEco.DataManagement.Files.File.FindAndCreateTable.html?format=raw"><img src="next.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Next Page" /></a></td><td align="center" width="100%">GeoEco Python Reference</td><td class="online-navigation"><a title="Table of Contents" href="TableOfContents.html?format=raw"><img src="contents.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Table of Contents" /></a></td><td class="online-navigation"><a title="Module Index" href="ModuleIndex.html?format=raw"><img src="modules.png?format=raw" border="0" align="bottom" height="32" width="32" alt="Module Index" /></a></td><td class="online-navigation"><img src="blank.png?format=raw" border="0" align="bottom" height="32" width="32" alt="" /></td></tr></table><div class="online-navigation"><b class="navlabel">Previous:</b> <a class="sectref" href="Method_GeoEco.DataManagement.Files.File.FindAndCopy.html?format=raw">FindAndCopy Method</a> <b class="navlabel">Up:</b> <a class="sectref" href="Class_GeoEco.DataManagement.Files.File.html?format=raw">File Class</a> <b class="navlabel">Next:</b> <a class="sectref" href="Method_GeoEco.DataManagement.Files.File.FindAndCreateTable.html?format=raw">FindAndCreateTable Method</a> </div><hr /><span class="release-info">Marine Geospatial Ecology Tools version 0.7a1</span></div></div></body></html>
Note: See TracBrowser for help on using the browser.