org.languagetool.rules

Class AbstractStatisticSentenceStyleRule

java.lang.Object

org.languagetool.rules.Rule

org.languagetool.rules.TextLevelRule

org.languagetool.rules.AbstractStatisticSentenceStyleRule

Direct Known Subclasses:

ConjunctionAtBeginOfSentenceRule, PassiveSentenceRule, SentenceWithManRule, SentenceWithModalVerbRule

public abstract class AbstractStatisticSentenceStyleRule
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
AbstractStatisticSentenceStyleRule(ResourceBundle messages, Language lang, UserConfig userConfig, int minPercent)
AbstractStatisticSentenceStyleRule(ResourceBundle messages, Language lang, UserConfig userConfig, int minPercent, boolean defaultActive)

Method Summary

Modifier and Type	Method and Description
protected abstract AnalyzedTokenReadings	conditionFulfilled(List<AnalyzedTokenReadings> tokens) 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()
int	getSentenceCount()
boolean	hasConfigurableValue() Overwrite this to return true, if a value may be configured by option panel
protected boolean	isMark(AnalyzedTokenReadings token)
protected boolean	isOpeningQuote(AnalyzedTokenReadings token)
RuleMatch[]	match(List<AnalyzedSentence> sentences)
int	minToCheckParagraph() Gives back the minimum number of paragraphs to check to give back a correct result.
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

AbstractStatisticSentenceStyleRule

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

AbstractStatisticSentenceStyleRule

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

Method Detail

conditionFulfilled

protected abstract AnalyzedTokenReadings conditionFulfilled(List<AnalyzedTokenReadings> tokens)

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

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

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

isMark

protected boolean isMark(AnalyzedTokenReadings token)

isOpeningQuote

protected boolean isOpeningQuote(AnalyzedTokenReadings token)

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

getSentenceCount

public int getSentenceCount()

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