Filter

Description:
This module carries out the operation described by the formula and selects the entities in the map for which the formula is true.

You can do two kinds of filtering :

• a numerical filtering, available thanks to the Numeric tab. This kind of filtering is only available if the inputs are continuous data or continuous matrices.
• a text filtering, available thanks to the Text tab. This kind of filtering is only available if the inputs are working maps or qualitative data or alphabetical data.

This module changes its type of calculation as a function of the input data.

Numeric tab



This tab is accessible if the input data are continuous data or continuous matrices.

The inputs are coded using letters (capitals or small letters are accepted). You can use as many letters as there are inputs.

You can change the order of the inputs by moving them vertically, and then clicking on the Apply or OK button.

Formula:
The functions and operators available for the formula are identical to those proposed in the calculation module.

Text tab



This tab is accessible if the inputs are working maps or qualitative data or alphabetical data.

You can filter three kinds of texts :

• values, available only if data input are qualitative or alphabetical data.
• entities names, available only if the inputs are working maps.
• entities identifiers, available only if the inputs are working maps.

Formula :
Four lines are supplied for the text filtering. The criteria you will specify on these lines can be combinated with an And operator (in this case, filtered entities must satisfy all criteria) or an Or operator (in this case, filtered entities must satisfy at least one criterium).

Each line is made of four parameters:

• input data name
• one operator
• one value zone
• a second value zone

You just have to "read" the lines to get the formula. On the above image, we want in the "cee.vxf" working map all the entities which name is equal to "France" or "Italie" (capitals or small letters are same).

List of supplied operators :

• =
• <
• < =
• >
• > =
• between
• none

If a line has the between operator, then the two values zones located on the same line must be filled. The filtered entities must be strictly superior to the first value and strictly inferior to the second one.

If a line has the none operator, then this line will not be considered in formula.

ATTENTION : the lines must be filled in the order. If the first line is empty and the second line is filled, it won't work.

Data window:
The module is linked to a window called "..... Window", identical to that of the working map module, in which all the data concerning the filtered map are displayed.

Module output:
A new map is generated using the formula. Depending on the choice of output, Map or Data, the module supplies the map thus created or the associated data. The type of this data depends on the input data type:

• If the continuous data or continuous matrices are available in input, the ouput will be a continuous data.
• If the qualitative data are available in input, the ouput will be a qualitative data.
• If the alphabetical data are available in input, the ouput will be an alphabetical data.

If several modules are connected to the input, the filter supplies data from the first one.

Notice : if the inputs are continuous matrices, the output type is set to data type.

Script:

2      module untyped_list ""
3        mod_type integer "103"
3        mod_subtype integer "514"
3        mod_name string "filter"
3        mod_dads integer_list ""
4          ? integer "4"
4          ? integer "5"
4          ? integer "6"
3        filter_num boolean "T"
3        input_type integer "2"
3        formula string "A-B+C-30>20"
3        work_on_input boolean "F"
3        output_map boolean "T"
3        work_on_matrix boolean "F"
3        filter_data boolean "T"
3        filter_name boolean "F"
3        filter_id boolean "F"
3        operation_and boolean "T"
3        data1 string "CEELIST2.DAT (1)"
3        data2 string "CEELIST2.DAT (1)"
3        data3 string "CEELIST2.DAT (1)"
3        data4 string "CEELIST2.DAT (1)"
3        oper1 string "rien"
3        oper2 string "rien"
3        oper3 string "rien"
3        oper4 string "rien"
3        val1 string ""
3        val2 string ""
3        val3 string ""
3        val4 string ""
3        val1_sup string ""
3        val2_sup string ""
3        val3_sup string ""
3        val4_sup string ""