org.languagetool.rules

Class AbstractStatisticStyleRule

java.lang.Object

org.languagetool.rules.Rule

org.languagetool.rules.TextLevelRule

org.languagetool.rules.AbstractStatisticStyleRule

Direct Known Subclasses:

GermanFillerWordsRule, NonSignificantVerbsRule, UnnecessaryPhraseRule

public abstract class AbstractStatisticStyleRule
extends TextLevelRule

A rule that gives hints when a defined condition is fulfilled and the percentage of hints in the text exceeds the given limit. (For office extension: Works on the level of chapters) A limit of 0 shows all hints. Direct speech or citation can be excluded. A second condition per sentences can be defined. The rule detects no grammar error but gives stylistic hints in a statistic way (default off).

Since:

5.3

Author:

Fred Kruse

Field Summary

Fields inherited from class org.languagetool.rules.Rule

messages

Constructor Summary

Constructors

Constructor and Description
AbstractStatisticStyleRule(ResourceBundle messages, Language lang, UserConfig userConfig, int minPercent)
AbstractStatisticStyleRule(ResourceBundle messages, Language lang, UserConfig userConfig, int minPercent, boolean defaultActive)

Method Summary

Modifier and Type	Method and Description
protected abstract int	conditionFulfilled(AnalyzedTokenReadings[] tokens, int nAnalysedToken) Condition to generate a hint (possibly including all exceptions) Returns: < nAnalysedToken, if condition is not fulfilled >= nAnalysedToken, if condition is not fulfilled; integer is number of token which is the end hint
double	denominator() Override, if value should be given in an other unity than percent
protected abstract boolean	excludeDirectSpeech() Condition to generate a hint related to the sentence (possibly including all exceptions)
abstract String	getConfigureText() Overwrite this to define the Text in the option panel for the configurable value
int	getDefaultValue() Overwrite this to get a default Integer value by option panel
protected abstract String	getLimitMessage(int limit, double percent) Defines the message for hints which exceed the limit
int	getMaxConfigurableValue() Overwrite this to define the maximum of a configurable value
int	getMinConfigurableValue() Overwrite this to define the minimum of a configurable value
int	getNumberOfMatches()
protected abstract String	getSentenceMessage() Defines the message for sentence related hints
int	getWordCount()
boolean	hasConfigurableValue() Overwrite this to return true, if a value may be configured by option panel
RuleMatch[]	match(List<AnalyzedSentence> sentences)
int	minToCheckParagraph() Gives back the minimum number of paragraphs to check to give back a correct result.
protected abstract boolean	sentenceConditionFulfilled(AnalyzedTokenReadings[] tokens, int nAnalysedToken) Condition to generate a hint related to the sentence (possibly including all exceptions)
void	setWithoutDirectSpeech(boolean withoutDirectSpeech)

Methods inherited from class org.languagetool.rules.TextLevelRule

estimateContextForSureMatch, match, match

Methods inherited from class org.languagetool.rules.Rule

addExamplePair, addTags, addToneTags, cacheAntiPatterns, getAntiPatterns, getCategory, getCorrectExamples, getDescription, getDistanceTokens, getErrorTriggeringExamples, getFullId, getId, getIncorrectExamples, getLocQualityIssueType, getMinPrevMatches, getSentenceWithImmunization, getSourceFile, getSubId, getTags, getToneTags, getUrl, hasTag, hasToneTag, isDefaultOff, isDefaultTempOff, isDictionaryBasedSpellingRule, isGoalSpecific, isOfficeDefaultOff, isOfficeDefaultOn, isPremium, makeAntiPatterns, setCategory, setCorrectExamples, setDefaultOff, setDefaultOn, setDefaultTempOff, setDistanceTokens, setErrorTriggeringExamples, setExamplePair, setGoalSpecific, setIncorrectExamples, setLocQualityIssueType, setMinPrevMatches, setOfficeDefaultOff, setOfficeDefaultOn, setPremium, setTags, setToneTags, setUrl, supportsLanguage, toRuleMatchArray, useInOffice

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractStatisticStyleRule

public AbstractStatisticStyleRule(ResourceBundle messages,
                                  Language lang,
                                  UserConfig userConfig,
                                  int minPercent,
                                  boolean defaultActive)

AbstractStatisticStyleRule

public AbstractStatisticStyleRule(ResourceBundle messages,
                                  Language lang,
                                  UserConfig userConfig,
                                  int minPercent)

Method Detail

conditionFulfilled

protected abstract int conditionFulfilled(AnalyzedTokenReadings[] tokens,
                                          int nAnalysedToken)

Condition to generate a hint (possibly including all exceptions) Returns: < nAnalysedToken, if condition is not fulfilled >= nAnalysedToken, if condition is not fulfilled; integer is number of token which is the end hint

sentenceConditionFulfilled

protected abstract boolean sentenceConditionFulfilled(AnalyzedTokenReadings[] tokens,
                                                      int nAnalysedToken)

Condition to generate a hint related to the sentence (possibly including all exceptions)

excludeDirectSpeech

protected abstract boolean excludeDirectSpeech()

Condition to generate a hint related to the sentence (possibly including all exceptions)

getLimitMessage

protected abstract String getLimitMessage(int limit,
                                          double percent)

Defines the message for hints which exceed the limit

getSentenceMessage

protected abstract String getSentenceMessage()

Defines the message for sentence related hints

getConfigureText

public abstract String getConfigureText()

Description copied from class: Rule

Overwrite this to define the Text in the option panel for the configurable value

Overrides:

getConfigureText in class Rule

denominator

public double denominator()

Override, if value should be given in an other unity than percent

hasConfigurableValue

public boolean hasConfigurableValue()

Description copied from class: Rule

Overwrite this to return true, if a value may be configured by option panel

Overrides:

hasConfigurableValue in class Rule

getDefaultValue

public int getDefaultValue()

Description copied from class: Rule

Overwrite this to get a default Integer value by option panel

Overrides:

getDefaultValue in class Rule

getMinConfigurableValue

public int getMinConfigurableValue()

Description copied from class: Rule

Overwrite this to define the minimum of a configurable value

Overrides:

getMinConfigurableValue in class Rule

getMaxConfigurableValue

public int getMaxConfigurableValue()

Description copied from class: Rule

Overwrite this to define the maximum of a configurable value

Overrides:

getMaxConfigurableValue in class Rule

getWordCount

public int getWordCount()

getNumberOfMatches

public int getNumberOfMatches()

setWithoutDirectSpeech

public void setWithoutDirectSpeech(boolean withoutDirectSpeech)

match

public RuleMatch[] match(List<AnalyzedSentence> sentences)
                  throws IOException

Specified by:

match in class TextLevelRule

Throws:

IOException

minToCheckParagraph

public int minToCheckParagraph()

Description copied from class: TextLevelRule

Gives back the minimum number of paragraphs to check to give back a correct result. Only used by LO office extension.

• n == -1 --> need to check full text (use only if really needed / bad performance) examples: AbstractWordCoherencyRule, GenericUnpairedBracketsRule, ...
• n == 0 --> need only to check the current paragraph examples: MultipleWhitespaceRule, LongParagraphRule, ...
• n >= 1 --> need only to check n paragraphs around the current paragraph examples: ParagraphRepeatBeginningRule (n == 1), WordRepeatBeginningRule (n == 2), ...

Specified by:

minToCheckParagraph in class TextLevelRule