Mail::SpamAssassin::Plugin::NeuralNetwork(3pm)

NAME
Mail::SpamAssassin::Plugin::NeuralNetwork - check messages using Fast Artificial Neural Network library

SYNOPSIS
  loadplugin Mail::SpamAssassin::Plugin::NeuralNetwork

DESCRIPTION
This plugin checks emails using Neural Network algorithm.

CAVEATS
The SpamAssassin learning subsystem routes all training through the Bayes scanner infrastructure. As a result, "Mail::SpamAssassin::Plugin::Bayes" must be loaded and "use_bayes 1" must be set for this plugin's training to be triggered.

neuralnetwork_data_dir dirname (default: undef)
    Where NeuralNetwork plugin will store its data.

neuralnetwork_min_text_len n (default: 256)
    Minimum number of characters of visible text required to run prediction or learning on a message.

neuralnetwork_min_word_len n (default: 4)
    Minimum token length considered when building the vocabulary and feature vectors.

neuralnetwork_max_word_len n (default: 24)
    Maximum token length considered when building the vocabulary and feature vectors.

neuralnetwork_vocab_cap n (default: 10000)
    Maximum number of vocabulary terms to retain; least-frequent terms are pruned when exceeded.

neuralnetwork_cache_ttl n (default: 300)
    Time-to-live in seconds for the in-memory vocabulary and model caches Set to 0 to disable caching.

neuralnetwork_min_spam_count n (default: 100)
    Minimum number of spam messages in the vocabulary required to enable prediction.

neuralnetwork_min_ham_count n (default: 100)
    Minimum number of ham messages in the vocabulary required to enable prediction.

neuralnetwork_spam_threshold f (default: 0.8)
    Prediction values above this threshold are considered spam.

neuralnetwork_ham_threshold f (default: 0.2)
    Prediction values below this threshold are considered ham.

neuralnetwork_learning_rate f (default: 0.1)
    Learning rate used by the underlying FANN network during incremental training.

neuralnetwork_momentum f (default: 0.1)
    Momentum used for training updates.

neuralnetwork_train_epochs n (default: 50)
    Number of training epochs to perform when learning a single message.

neuralnetwork_train_algorithm FANN_TRAIN_QUICKPROP|FANN_TRAIN_RPROP|FANN_TRAIN_BATCH|FANN_TRAIN_INCREMENTAL (default: FANN_TRAIN_RPROP)
    Algorithm used by Fann neural network used when training, might increase speed depending on the data volume.

neuralnetwork_lock_timeout n (default: 10)
    Maximum number of seconds to wait for the exclusive training lock before giving up and skipping the learn operation. Set to 0 to wait indefinitely.

neuralnetwork_rprop_delta_max n (default: 0.5)
    Delta value to apply to RPROP training replay loop.

neuralnetwork_stopwords words (default: "the and for with that this from there their have be not but you your")
    Space-separated list of stopwords to ignore when tokenizing text.

neuralnetwork_autolearn 0|1 (default 0)
    When SpamAssassin declares a message a clear spam or ham during the message scan, and launches the auto-learn process, message is autolearned as spam/ham in the same way as during the manual learning. Value 0 at this option disables the auto-learn process for this plugin.

neuralnetwork_dsn                (default: none)
    The DBI dsn of the database to use.

    For SQLite, the database will be created automatically if it does not already exist, the supplied path and file must be read/writable by the user running spamassassin or spamd.

    For MySQL/MariaDB or PostgreSQL, see sql-directory for database table creation clauses.

    You will need to have the proper DBI module for your database. For example DBD::SQLite, DBD::mysql, DBD::MariaDB or DBD::Pg.

    Minimum required SQLite version is 3.24.0 (available from DBD::SQLite 1.59_01).

    Examples:

     neuralnetwork_dsn dbi:SQLite:dbname=/var/lib/spamassassin/NeuralNetwork.db

neuralnetwork_username  (default: none)
    The username that should be used to connect to the database. Not used for SQLite.

neuralnetwork_password (default: none)
    The password that should be used to connect to the database. Not used for SQLite.

neuralnetwork_min_vocab_hits n (default: 10)
    Minimum number of tokens in the email that must exist in the vocabulary for prediction to run.