Online Help

base : one of bindir, currentdir, datadir, homedir, mapledir, tempdir, toolboxdir, or worksheetdir.

The base option specifies a base directory. Any local file specified with parameter origin will be interpreted as a relative path under this directory.

For the meaning of each of these values, see kernelopts or interface .

format : string

The format option specifies the import format to use. This must correspond to one of the supported import formats. If omitted, the import format is inferred from the file extension and/or MIME type of origin.

labeltype : one of symbol or string

When output=DataFrame, this option specifies whether non-numeric row and column labels should be expressed as symbols or strings when constructing the DataFrame.

The default is symbol.

output : symbol

This option specifies the desired method for representing the imported data in Maple. Supported values are summarized in the following table.

The default is auto, which specifies that a suitable format should be automatically inferred from the format. To determine the default behavior and supported values of output for a particular format, consult the documentation for that format.

plotoptions : list of equation

A list consisting of zero or more plot options described in plot,options . These are only applied if the output is a plot, and are otherwise ignored.

source : one of file or direct

This specifies whether the parameter origin refers to a file or URL (value file) or from a string or ByteArray in memory (value direct). The default is file.

title : string

A string descriptor for the imported object. May be used by any of the import routines as a caption or title in the imported object. Supersedes any title provided in plotoptions.

The Import command provides a generic mechanism for importing data in various file formats. The source data can be an external file or URL or a string or ByteArray in the current session.

The form which the imported data takes in Maple is determined by the format (either inferred or specified by the format option) and the output option.

The source option may be set to file or direct. The default, source=file, specifies that the data should be read from the file referenced by origin. In contrast source=direct means that origin is a string or ByteArray which directly contains the data. Note that source=direct requires format to be provided explicitly.

For details on controlling the form of imported data for a particular format, consult the documentation for that format.

$\mathrm{Import}\left(''example/timedata.csv''\,\mathrm{base}=\mathrm{datadir}\right)$

$\begin{array}{c}\left[\begin{array}{ccccccc}& 1& 2& 3& 4& 5& 6\\ 1& ''Mar\; 06\; 01:16''& ''3/7/2005''& 26.86091241& 1.414301472\times {10}^7& 1.505894402\times {10}^7& 0.0648\\ 2& ''Mar\; 06\; 20:12''& ''3/7/2005''& 25.75624181& 2.358229695\times {10}^7& 2.497614407\times {10}^7& 0.0591\\ 3& ''Mar\; 06\; 20:43''& ''3/7/2005''& 25.12706428& 3.029212316\times {10}^7& 3.314477184\times {10}^7& 0.0942\\ 4& ''Mar\; 07\; 00:25''& ''3/7/2005''& 25.12249095& 2.496855419\times {10}^7& 2.656019993\times {10}^7& 0.0637\\ 5& ''Mar\; 07\; 00:44''& ''3/7/2005''& 22.75919276& 2.722498752\times {10}^7& 2.818590004\times {10}^7& 0.0353\\ 6& ''Mar\; 07\; 00:59''& ''3/7/2005''& 22.20631112& 9.859010832\times {10}^7& 1.029975998\times {10}^7& 0.0447\\ 7& ''Mar\; 08\; 00:15''& ''3/8/2005''& 22.11477298& 8.333640321\times {10}^7& 8.579230226\times {10}^7& 0.0295\\ 8& ''Mar\; 08\; 00:16''& ''3/8/2005''& 21.41227113& 1.174272859\times {10}^7& 1.217998806\times {10}^7& 0.0372\\ 9& ''Mar\; 08\; 00:16''& ''3/8/2005''& 21.33253315& 4.950350549\times {10}^6& 5.239008009\times {10}^7& 0.0583\\ 10& ''Mar\; 08\; 00:16''& ''3/8/2005''& 20.62752309& 1.765508208\times {10}^7& 1.870092003\times {10}^7& 0.0592\\ ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& ⋮\end{array}\right]\\ \text{28 x 6 DataFrame}\end{array}$

$\mathrm{url}≔''http://www.maplesoft.com/data/examples/jpg/fingerprint.jpg''$

$\mathrm{url}≔''http://www.maplesoft.com/data/examples/jpg/fingerprint.jpg''$

$\mathrm{image}≔\mathrm{Import}\left(\mathrm{url}\right)$

$\begin{array}{c}\left[\begin{array}{ccccccccccc}0.188235294117647& 0.568627450980392& 0.505882352941176& 0.470588235294118& 0.494117647058824& 0.505882352941176& 0.486274509803922& 0.509803921568627& 0.501960784313725& 0.501960784313725& \dots \\ 0.541176470588235& 0.984313725490196& 0.992156862745098& 0.992156862745098& 1.& 1.& 0.992156862745098& 1.& 1.& 1.& \dots \\ 0.478431372549020& 0.960784313725490& 1.& 1.& 1.& 0.984313725490196& 0.964705882352941& 0.996078431372549& 0.996078431372549& 0.996078431372549& \dots \\ 0.517647058823529& 0.996078431372549& 1.& 1.& 0.988235294117647& 0.980392156862745& 0.972549019607843& 1.& 1.& 1.& \dots \\ 0.501960784313725& 0.976470588235294& 1.& 0.980392156862745& 0.988235294117647& 1.& 1.& 1.& 1.& 1.& \dots \\ 0.478431372549020& 0.960784313725490& 0.992156862745098& 0.980392156862745& 1.& 1.& 0.988235294117647& 0.988235294117647& 0.996078431372549& 0.996078431372549& \dots \\ 0.501960784313725& 0.992156862745098& 1.& 0.992156862745098& 1.& 1.& 0.980392156862745& 0.980392156862745& 1.& 1.& \dots \\ 0.494117647058824& 0.984313725490196& 1.& 0.972549019607843& 0.972549019607843& 1.& 1.& 1.& 0.992156862745098& 0.992156862745098& \dots \\ 0.498039215686275& 1.& 0.992156862745098& 1.& 1.& 0.980392156862745& 0.996078431372549& 0.992156862745098& 1.& 1.& \dots \\ 0.494117647058824& 0.996078431372549& 0.992156862745098& 1.& 1.& 0.984313725490196& 0.996078431372549& 0.996078431372549& 1.& 1.& \dots \\ ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& ⋮& \end{array}\right]\\ \text{240 × 256 Array}\end{array}$

$\mathrm{ImageTools}:-\mathrm{Embed}\left(\mathrm{image}\right)$

$\mathrm{Import}\left(''example/gear.ply''\,\mathrm{base}=\mathrm{datadir}\right)$

$\mathrm{Import}\left(''example/address.json''\,\mathrm{base}=\mathrm{datadir}\right)$

$table\left(\left[''address''=table\left(\left[''province''=''ON''\,''postalCode''=''N2V\; 1K8''\,''country''=''Canada''\,''streetAddress''=''615\; Kumpf\; Drive''\,''city''=''Waterloo''\right]\right)\,''phoneNumbers''=\left[table\left(\left[''number''=''+1\; (519)\; 747-2373''\,''type''=''local''\right]\right)\,table\left(\left[''number''=''+1\; (800)\; 267-6583''\,''type''=''tollfree''\right]\right)\,table\left(\left[''number''=''+1\; (519)\; 747-5284''\,''type''=''fax''\right]\right)\right]\,''founded''=1988\,''companyName''=''Maplesoft''\right]\right)$

$\mathrm{Import}\left(''example/EuropeMap.kmz''\,\mathrm{base}=\mathrm{datadir}\,\mathrm{plotoptions}=\left[\mathrm{view}=\left[-13..12\,46..64\right]\,\mathrm{title}=''Northwest\; Europe''\,\mathrm{titlefont}=\left[\mathrm{Times}\,\mathrm{Bold}\,20\right]\right]\right)$

$\mathrm{CityData}≔''City,Population\backslash nBeijing,21500000\backslash nMumbai,12478447\backslash nNew\; York,8405837\backslash n''\:$

$\mathrm{Import}\left(\mathrm{CityData}\,\mathrm{source}=\mathrm{direct}\,\mathrm{format}=''CSV''\right)$

$\left[\begin{array}{cc}& \mathrm{Population}\\ \mathrm{Beijing}& 21500000\\ \mathrm{Mumbai}& 12478447\\ \mathrm{New\; York}& 8405837\end{array}\right]$

The Import command was updated in Maple 2016. By default, Import returns a DataFrame object when importing from the following rectangular formats: CSV , DIF , TSV , XLS , and XLSX . Additionally Import returns a DataSeries object by default when importing from the ODS or SXC formats. Import also supports two new file formats: CNF and GEXF .

The Import command was introduced in Maple 2015.

For more information on Maple 2015 changes, see Updates in Maple 2015 .

The Import command was updated in Maple 2017.

The base option was introduced in Maple 2017.

For more information on Maple 2017 changes, see Updates in Maple 2017 .

The labeltype option was introduced in Maple 2023.

For more information on Maple 2023 changes, see Updates in Maple 2023 .