Loading one or many files

The most common first step when creating a new project in EasyMorph, is to load in data from one or more files. Files can be loaded either:

• one file at a time, specifying the specific file; or
• multiple files at once, either selecting the desired files from within a single folder, or defining a search query to load all files which match the search; or
• by loading or creating a list of files, then logically looping through the list loading them in to one or more tables.

The latter is considered an advanced method and so is covered in the "Advanced topics" section at the bottom of this page.

Supported file types

EasyMorph supports loading data from a wide range of file types:

This tutorial would be incredibly long if all possible file types named above were covered in detail. However, the process differs very little between file types and so even if your specific file type is not covered below, you can still follow the same steps and should find it possible load in your file(s).

Loading one file at a time

There are several ways to load a single data file in to EasyMorph. In this tutorial we will look at the most commonly used method. Open your EasyMorph projector create a new one. Then on the "Main" tab select "Add data", followed by "Import file" and then select the option to match the file type of your data file.

In the dialog that appears, browse to the data file you wish to load into EasyMorph, select it and click "Open". EasyMorph will automatically add the relevant action to load the file with the default options for that type.

You can tailor the default options as needed if the file is not loaded as you expect. The options available will vary depending on the type of file being loaded. When configuring the action options for your file, it can be helpful to see the contents and how the different options may effect how the data will be loaded. To do this, click on "Show preview" at the top right of the action options sidebar.

The top half of the preview shows the data as it appears in the file. The bottom half of the window shows how the data will look once loaded using the current options and will be updated as you make changes to the configuration options.

Loading multiple files simultaneously

In EasyMorph, it is possible to load multiple files from a single folder simultaneously, combining them into one table. This is done in a similar way to loading a single data file. Open your EasyMorph projector create a new one. Then on the "Main" tab select "Add data", followed by "Import multiple files" and then select the option to match the file type of your data files.

In the dialog that appears, select the folder that contains the files you wish to load. There are 2 selection modes available: "Select" and "Search". In Select mode, you can pick the desired files from the list shown by selecting the checkboxes next to the file names. Once all required files are chosen, click "OK" and EasyMorph will automatically add the required action to load that file type.

In Search mode, rather than selecting individual files, you can specify a search string instead. EasyMorph will then load in all files in the folder which match the search. Searches can be specified as one of 3 types:

• Plain text - All files which contain the specified string will be returned. The search is not case sensitive.
• Wildcard - All files which contain the specified pattern containing one or more "*" as wildcards will be returned (e.g. "dat*")
• Regular expression - All files which match the provided regular expressions pattern will be returned.

EasyMorph shows the list of files which match the provided search. Once happy with the selection, click "OK" and EasyMorph will automatically add the required action to load that file type.

Which ever mode is used, all of the files selected will be returned and added into a single table in the same way as a "UNION" in SQL. This is some times called "concatenating". If the files are not the same structure (i.e. have the same number of columns all named the same), columns with the same name will be "lined up". Columns that are not in all files will still be included in the resulting table but the value with be "empty" for those records which are loaded from a file that doesn't contain the column.

Loading a folder into EasyMorph

As well as loading the contents of data files, it is also possible to load a folder into EasyMorph. When doing this, rather than the result being a table containing the data from within the files, EasyMorph will create a table containing a list of the files within the folder. This can be useful as a starting point for then performing more advanced file actions or for applying advance filtering of the files you wish to subsequently load data from (e.g. only load from files under 100Mb).

To load a list of files within a folder, on the "Main" tab select "Generate data", followed by "List of files". In the dialog that appears, select the folder containing the files you wish to list.

By default, EasyMorph adds a single column to the resulting table which contains the full path, filename and extension. It is possible to specify other columns instead or in addition using the action options on the left. Additionally you can specify whether subfolders should also be scanned and included.

Once you have a list of files in EasyMorph, you can then loop through the list, loading data from them. For more information on how to do this, please see the Advanced topics section below.

Advanced topics

Loading a list of files

Loading a list of files is a powerful feature that allows loading and automatically concatenating multiple files defined by a list of file paths. The list of files to load can be defined by various rules that not only include file name, but also file size, file creation date, or file extension. A few examples:

• Load only the latest 10 files based on file creation date
• Extract timestamps from file names, load only the latest 10 files based on the timestamps
• When multiple files per day exist, load only the latest file
• Exclude files with zero length
• Load only files with timestamps that aren't already loaded
• Include files from subfolders
• Extract timestamps from subfolder names

Loading a list of files typically requires 3 steps:

1. Obtain a list of files using the "List of files" action.
2. Filter the list of files.
3. Load all files from the list into one table using a file import action in the "Load list of files" mode.

Obtaining a list of files is most frequently done using the "List of files" action. This action generates a table with a list of files in specified folder. The list can include not just file paths, but also file size, creation date and extension. There are other ways to produce a list of files in EasyMorph. For instance, the "Fetch email" action receives emails and saves their attachments into a designated folder, returning a list of saved files.

The list of files to load can further be filtered using one or more filtering actions. For instance, you can keep only files with sizes greater than 10'000 bytes. See also the chapter "Filtering data" in this tutorial.

Finally, use an appropriate file import action in the "Load list of files" mode and specify the column that contains the list of files. Note that the list should consist of full file paths, not just names.

Processing very big text files

If the file(s) to load are too big (e.g. hundreds of gigabytes) and can't fit in memory then you can split them into chunks first, and process one chunk at a time. The "Split delimited files" action splits text files into chunks based either on the number of rows (used for files with fixed width columns), or unique values in a particular field (i.e. partitioning of delimited text files). The action returns a list of created files (the chunks), which can further be used for iterating.