Read CSV (RapidMiner Studio Core)

Parameters

• Import_Configuration_Wizard

  This user-friendly wizard guides you to easily configure this Operator to import the CSV file.

  Range:
• csv_file

  The path of the CSV file is specified here. It can also be selected using the 'Choose a file' button.

  Range:
• column_separators

  Column separators for CSV files can be specified here. It can also be provided as a regular expression. A good understanding of regular expressions can be developed by studying the description of Select Attributes Operator and its tutorial Processes.

  Range:
• trim_lines

  This parameter indicates if lines should be trimmed (removal of empty spaces at the beginning and the end) before the column split is performed. This option might be problematic if TABs ('\t') are used as separators.

  Range:
• use_quotes

  This parameter indicates if quotes should be regarded. Quotes can be used to store special characters like column separators. For example if (,) is set as column separator and (") is set as quotes character, then a row (a,b,c,d) will be translated as 4 values for 4 columns. On the other hand ("a,b,c,d") will be translated as a single column value a,b,c,d. If this parameter is set to false, the quotes character parameter and the escape character parameter cannot be defined.

  Range:
• quotes_character

  This parameter defines the quotes character and is only available if use quotes is set to true.

  Range:
• escape_character

  This parameter specifies the character used to escape the quotes and is only available if use quotes is set to true. For example, if (") is used as quotes character and ('\') is used as escape character, then ("yes") will be translated as (yes) and (\"yes\") will be translated as ("yes").

  Range:
• skip_comments

  This parameter is used to ignore comments in the CSV file (if any). If this option is set to true, a comment character should be defined using the comment characters parameter.

  Range:
• comment_characters

  This parameter is available if comment characters is set to true. Lines beginning with these characters are ignored. If this character is present in the middle of the line, anything that comes in that line after this character is ignored. The comment character itself is also ignored.

  Range:
• parse_numbers

  This parameter specifies whether numbers are parsed or not.

  Range:
• decimal_character

  This character is used as the decimal character.

  Range:
• grouped_digits

  This parameter decides whether grouped digits should be parsed or not. If this parameter is set to true, a grouping character parameter has to be specified.

  Range:
• grouping_character

  This character is used as the grouping character. If this character is found between numbers, the numbers are combined and this character is ignored. For example if "22-14" is present in the CSV file and "-" is set as the grouping character, then "2214" will be stored.

  Range:
• infinity_string

  This parameter can be set to parse a specific infinity representation (e.g. "Infinity"). If it is not set, the local specific infinity representation will be used.

  Range: string
• date_format

  The parameter specifies the date and time format. Many predefined options exist but users can also specify a new format. If text in a CSV file column matches this date format, that column is automatically converted to date type.

  Some corrections are automatically made on invalid date values. For example, a value '32-March' will automatically be converted to '1-April'.

  Columns containing values which cannot be interpreted as numbers will be interpreted as nominal, as long as they do not match the date and time pattern of the date format parameter. If they match, this column of the CSV file will be automatically parsed as date and the corresponding Attribute will be of type date.

  Range:
• first_row_as_names

  If this parameter is set to true, it is assumed that the first line of the CSV file has the names of the Attributes. If so, the Attributes are automatically named and the first line of the CSV file is not treated as a data line.

  Range:
• annotations

  If the first row as names is not set to true, annotations can be added using the 'Edit List' button of this parameter, which opens a new menu. This menu allows you to select any row and assign an annotation to it. Name, Comment and Unit annotations can be assigned. If row 0 is assigned a Name annotation, it is equivalent to setting the first row as names parameter to true. If you want to ignore any row, you can annotate them as Comment. Remember that row number in this menu does not count commented lines.

  Range:
• time_zone

  Users can select any time zone from the list of provided time zones.

  Range:
• locale

  Users can select any locale from the list of provided locales.

  Range:
• encoding

  Users can select any encoding from the list of provided encodings.

  Range:
• read_all_values_as_polynominal

  This option allows you to disable the type handling for this operator. Every column will be read as a polynominal attribute.

  Range:
• data_set_meta_data_information

  This parameter allows to adjust or override the meta data of the CSV file. Column index, name, type and role can be specified here.

  The Read CSV Operator automatically tries to determine an appropriate data type of the Attributes by reading the first few lines and checking the occurring values. Integer values are assigned the integer data type, real values the real data type. Values which cannot be interpreted as numbers are assigned the nominal data type, as long as they do not match the format of the date format parameter.

  With the data set meta data information parameter, this automatic assignment can be adjusted or overwritten.

  Range:
• read_not_matching_values_as_missings

  If this parameter is set to true, values that do not match with the expected value type are considered as missing values and are replaced by '?'. For example, if 'abc' is written in an integer column, it will be treated as a missing value. A question mark (?) in the CSV file is also read as a missing value.

  Range:
• data_management

  This parameter determines how the data is represented internally. Users can select any option from the provided list.

  Range: