Create classification dataset (from categorized spectral library)

Create a classification dataset from spectral profiles that matches the given categories and store the result as a pickle file. If the spectral library is not categorized, or the field with class values is selected manually, categories are derived from target data y. To be more precise: i) category values are derived from unique attribute values (after excluding no data or zero data values), ii) category names are set equal to the category values, and iii) category colors are picked randomly.

Usage:

1. Open the algorithm from the processing toolbox.

2. Select a spectral library, then click run.

   

3. The output classification dataset will be listed under Models in your Data Sources panel.

Parameters

Categorized spectral library [vector]

Categorized spectral library with feature data X (i.e. spectral profiles) and target data y. It is assumed, but not enforced, that the spectral characteristics of all spectral profiles match. If not all spectral profiles share the same number of spectral bands, an error is raised.

Field with class values [field]

Field with class values used as target data y. If not selected, the field defined by the renderer is used. If that is also not specified, an error is raised.

Field with spectral profiles used as features [field]

Field with spectral profiles used as feature data X. If not selected, the default field named “profiles” is used. If that is also not available, an error is raised.

Exclude bad bands [boolean]

Whether to exclude bands, that are marked as bad bands, or contain no data, inf or nan values in all samples.

Default: True

Outputs

Output dataset [fileDestination]

Pickle file destination.

Command-line usage

>qgis_process help enmapbox:CreateClassificationDatasetFromCategorizedSpectralLibrary:

----------------
Arguments
----------------

categorizedLibrary: Categorized spectral library
    Argument type:  vector
    Acceptable values:
            - Path to a vector layer
categoryField: Field with class values (optional)
    Argument type:  field
    Acceptable values:
            - The name of an existing field
            - ; delimited list of existing field names
field: Field with spectral profiles used as features (optional)
    Argument type:  field
    Acceptable values:
            - The name of an existing field
            - ; delimited list of existing field names
excludeBadBands: Exclude bad bands (optional)
    Default value:  true
    Argument type:  boolean
    Acceptable values:
            - 1 for true/yes
            - 0 for false/no
            - field:FIELD_NAME to use a data defined value taken from the FIELD_NAME field
            - expression:SOME EXPRESSION to use a data defined value calculated using a custom QGIS expression
outputClassificationDataset: Output dataset
    Argument type:  fileDestination
    Acceptable values:
            - Path for new file

----------------
Outputs
----------------

outputClassificationDataset: <outputFile>
    Output dataset