Class/Object

com.johnsnowlabs.nlp.annotators.ner.dl

NerDLApproach

Related Docs: object NerDLApproach | package dl

Permalink

class NerDLApproach extends AnnotatorApproach[NerDLModel] with NerApproach[NerDLApproach] with Logging with ParamsAndFeaturesWritable

This Named Entity recognition annotator allows to train generic NER model based on Neural Networks.

The architecture of the neural network is a Char CNNs - BiLSTM - CRF that achieves state-of-the-art in most datasets.

For instantiated/pretrained models, see NerDLModel.

The training data should be a labeled Spark Dataset, in the format of CoNLL 2003 IOB with Annotation type columns. The data should have columns of type DOCUMENT, TOKEN, WORD_EMBEDDINGS and an additional label column of annotator type NAMED_ENTITY. Excluding the label, this can be done with for example

For extended examples of usage, see the Spark NLP Workshop and the NerDLSpec.

Example

import com.johnsnowlabs.nlp.base.DocumentAssembler
import com.johnsnowlabs.nlp.annotators.Tokenizer
import com.johnsnowlabs.nlp.annotators.sbd.pragmatic.SentenceDetector
import com.johnsnowlabs.nlp.embeddings.BertEmbeddings
import com.johnsnowlabs.nlp.annotators.ner.dl.NerDLApproach
import com.johnsnowlabs.nlp.training.CoNLL
import org.apache.spark.ml.Pipeline

// This CoNLL dataset already includes a sentence, token and label
// column with their respective annotator types. If a custom dataset is used,
// these need to be defined with for example:

val documentAssembler = new DocumentAssembler()
  .setInputCol("text")
  .setOutputCol("document")

val sentence = new SentenceDetector()
  .setInputCols("document")
  .setOutputCol("sentence")

val tokenizer = new Tokenizer()
  .setInputCols("sentence")
  .setOutputCol("token")

// Then the training can start
val embeddings = BertEmbeddings.pretrained()
  .setInputCols("sentence", "token")
  .setOutputCol("embeddings")

val nerTagger = new NerDLApproach()
  .setInputCols("sentence", "token", "embeddings")
  .setLabelColumn("label")
  .setOutputCol("ner")
  .setMaxEpochs(1)
  .setRandomSeed(0)
  .setVerbose(0)

val pipeline = new Pipeline().setStages(Array(
  embeddings,
  nerTagger
))

// We use the sentences, tokens and labels from the CoNLL dataset
val conll = CoNLL()
val trainingData = conll.readDataset(spark, "src/test/resources/conll2003/eng.train")

val pipelineModel = pipeline.fit(trainingData)
See also

NerConverter to further process the results

NerCrfApproach for a generic CRF approach

Linear Supertypes
ParamsAndFeaturesWritable, HasFeatures, Logging, NerApproach[NerDLApproach], AnnotatorApproach[NerDLModel], CanBeLazy, DefaultParamsWritable, MLWritable, HasOutputAnnotatorType, HasOutputAnnotationCol, HasInputAnnotationCols, Estimator[NerDLModel], PipelineStage, Logging, Params, Serializable, Serializable, Identifiable, AnyRef, Any
Ordering
  1. Grouped
  2. Alphabetic
  3. By Inheritance
Inherited
  1. NerDLApproach
  2. ParamsAndFeaturesWritable
  3. HasFeatures
  4. Logging
  5. NerApproach
  6. AnnotatorApproach
  7. CanBeLazy
  8. DefaultParamsWritable
  9. MLWritable
  10. HasOutputAnnotatorType
  11. HasOutputAnnotationCol
  12. HasInputAnnotationCols
  13. Estimator
  14. PipelineStage
  15. Logging
  16. Params
  17. Serializable
  18. Serializable
  19. Identifiable
  20. AnyRef
  21. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new NerDLApproach()

    Permalink
  2. new NerDLApproach(uid: String)

    Permalink

    uid

    required uid for storing annotator to disk

Type Members

  1. type AnnotatorType = String

    Permalink
    Definition Classes
    HasOutputAnnotatorType

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def $[T](param: Param[T]): T

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  4. def $$[T](feature: StructFeature[T]): T

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  5. def $$[K, V](feature: MapFeature[K, V]): Map[K, V]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  6. def $$[T](feature: SetFeature[T]): Set[T]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  7. def $$[T](feature: ArrayFeature[T]): Array[T]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  8. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  9. def _fit(dataset: Dataset[_], recursiveStages: Option[PipelineModel]): NerDLModel

    Permalink
    Attributes
    protected
    Definition Classes
    AnnotatorApproach
  10. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  11. val batchSize: IntParam

    Permalink

    Batch size (Default: 8)

  12. def beforeTraining(spark: SparkSession): Unit

    Permalink
    Definition Classes
    NerDLApproachAnnotatorApproach
  13. val bestModelMetric: Param[String]

    Permalink

    Whether to check F1 Micro-average or F1 Macro-average as a final metric for the best model This will fall back to loss if there is no validation or test dataset

  14. def calculateEmbeddingsDim(sentences: Seq[WordpieceEmbeddingsSentence]): Int

    Permalink
  15. final def checkSchema(schema: StructType, inputAnnotatorType: String): Boolean

    Permalink
    Attributes
    protected
    Definition Classes
    HasInputAnnotationCols
  16. final def clear(param: Param[_]): NerDLApproach.this.type

    Permalink
    Definition Classes
    Params
  17. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  18. val configProtoBytes: IntArrayParam

    Permalink

    ConfigProto from tensorflow, serialized into byte array.

    ConfigProto from tensorflow, serialized into byte array. Get with config_proto.SerializeToString()

  19. final def copy(extra: ParamMap): Estimator[NerDLModel]

    Permalink
    Definition Classes
    AnnotatorApproach → Estimator → PipelineStage → Params
  20. def copyValues[T <: Params](to: T, extra: ParamMap): T

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  21. final def defaultCopy[T <: Params](extra: ParamMap): T

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  22. val description: String

    Permalink

    Trains Tensorflow based Char-CNN-BLSTM model

    Trains Tensorflow based Char-CNN-BLSTM model

    Definition Classes
    NerDLApproachAnnotatorApproach
  23. val dropout: FloatParam

    Permalink

    Dropout coefficient (Default: 0.5f)

  24. val enableMemoryOptimizer: BooleanParam

    Permalink

    Whether to optimize for large datasets or not (Default: false).

    Whether to optimize for large datasets or not (Default: false). Enabling this option can slow down training.

  25. val enableOutputLogs: BooleanParam

    Permalink

    Whether to output to annotators log folder (Default: false)

  26. val entities: StringArrayParam

    Permalink

    Entities to recognize

    Entities to recognize

    Definition Classes
    NerApproach
  27. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  28. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  29. val evaluationLogExtended: BooleanParam

    Permalink

    Whether logs for validation to be extended (Default: false): it displays time and evaluation of each label

  30. def explainParam(param: Param[_]): String

    Permalink
    Definition Classes
    Params
  31. def explainParams(): String

    Permalink
    Definition Classes
    Params
  32. final def extractParamMap(): ParamMap

    Permalink
    Definition Classes
    Params
  33. final def extractParamMap(extra: ParamMap): ParamMap

    Permalink
    Definition Classes
    Params
  34. val features: ArrayBuffer[Feature[_, _, _]]

    Permalink
    Definition Classes
    HasFeatures
  35. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  36. final def fit(dataset: Dataset[_]): NerDLModel

    Permalink
    Definition Classes
    AnnotatorApproach → Estimator
  37. def fit(dataset: Dataset[_], paramMaps: Array[ParamMap]): Seq[NerDLModel]

    Permalink
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" )
  38. def fit(dataset: Dataset[_], paramMap: ParamMap): NerDLModel

    Permalink
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" )
  39. def fit(dataset: Dataset[_], firstParamPair: ParamPair[_], otherParamPairs: ParamPair[_]*): NerDLModel

    Permalink
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" ) @varargs()
  40. def get[T](feature: StructFeature[T]): Option[T]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  41. def get[K, V](feature: MapFeature[K, V]): Option[Map[K, V]]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  42. def get[T](feature: SetFeature[T]): Option[Set[T]]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  43. def get[T](feature: ArrayFeature[T]): Option[Array[T]]

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  44. final def get[T](param: Param[T]): Option[T]

    Permalink
    Definition Classes
    Params
  45. def getBatchSize: Int

    Permalink

    Batch size

  46. def getBestModelMetric: String

    Permalink

  47. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  48. def getConfigProtoBytes: Option[Array[Byte]]

    Permalink

    ConfigProto from tensorflow, serialized into byte array.

    ConfigProto from tensorflow, serialized into byte array. Get with config_proto.SerializeToString()

  49. def getDataSetParams(dsIt: Iterator[Array[(TextSentenceLabels, WordpieceEmbeddingsSentence)]]): (Set[String], Set[Char], Int, Long)

    Permalink
  50. final def getDefault[T](param: Param[T]): Option[T]

    Permalink
    Definition Classes
    Params
  51. def getDropout: Float

    Permalink

    Dropout coefficient

  52. def getEnableMemoryOptimizer: Boolean

    Permalink

    Memory Optimizer

  53. def getEnableOutputLogs: Boolean

    Permalink

    Whether to output to annotators log folder

  54. def getIncludeConfidence: Boolean

    Permalink

    whether to include confidence scores in annotation metadata

  55. def getInputCols: Array[String]

    Permalink

    returns

    input annotations columns currently used

    Definition Classes
    HasInputAnnotationCols
  56. def getIteratorFunc(dataset: Dataset[Row]): () ⇒ Iterator[Array[(TextSentenceLabels, WordpieceEmbeddingsSentence)]]

    Permalink
  57. def getLazyAnnotator: Boolean

    Permalink
    Definition Classes
    CanBeLazy
  58. def getLogName: String

    Permalink
    Definition Classes
    NerDLApproachLogging
  59. def getLr: Float

    Permalink

    Learning Rate

  60. def getMaxEpochs: Int

    Permalink

    Maximum number of epochs to train

    Maximum number of epochs to train

    Definition Classes
    NerApproach
  61. def getMinEpochs: Int

    Permalink

    Minimum number of epochs to train

    Minimum number of epochs to train

    Definition Classes
    NerApproach
  62. final def getOrDefault[T](param: Param[T]): T

    Permalink
    Definition Classes
    Params
  63. final def getOutputCol: String

    Permalink

    Gets annotation column name going to generate

    Gets annotation column name going to generate

    Definition Classes
    HasOutputAnnotationCol
  64. def getOutputLogsPath: String

    Permalink

    Folder path to save training logs

  65. def getParam(paramName: String): Param[Any]

    Permalink
    Definition Classes
    Params
  66. def getPo: Float

    Permalink

    Learning rate decay coefficient.

    Learning rate decay coefficient. Real Learning Rage = lr / (1 + po * epoch)

  67. def getRandomSeed: Int

    Permalink

    Random seed

    Random seed

    Definition Classes
    NerApproach
  68. def getUseBestModel: Boolean

    Permalink

    useBestModel

  69. def getUseContrib: Boolean

    Permalink

    Whether to use contrib LSTM Cells.

    Whether to use contrib LSTM Cells. Not compatible with Windows. Might slightly improve accuracy.

  70. def getValidationSplit: Float

    Permalink

    Choose the proportion of training dataset to be validated against the model on each Epoch.

    Choose the proportion of training dataset to be validated against the model on each Epoch. The value should be between 0.0 and 1.0 and by default it is 0.0 and off.

  71. def getVerbose: Int

    Permalink

    Level of verbosity during training

    Level of verbosity during training

    Definition Classes
    NerApproach
  72. val graphFolder: Param[String]

    Permalink

    Folder path that contain external graph files

  73. final def hasDefault[T](param: Param[T]): Boolean

    Permalink
    Definition Classes
    Params
  74. def hasParam(paramName: String): Boolean

    Permalink
    Definition Classes
    Params
  75. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  76. val includeAllConfidenceScores: BooleanParam

    Permalink

    whether to include all confidence scores in annotation metadata or just score of the predicted tag

  77. val includeConfidence: BooleanParam

    Permalink

    Whether to include confidence scores in annotation metadata (Default: false)

  78. def initializeLogIfNecessary(isInterpreter: Boolean, silent: Boolean): Boolean

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  79. def initializeLogIfNecessary(isInterpreter: Boolean): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  80. val inputAnnotatorTypes: Array[String]

    Permalink

    Input annotator types: DOCUMENT, TOKEN, WORD_EMBEDDINGS

    Input annotator types: DOCUMENT, TOKEN, WORD_EMBEDDINGS

    Definition Classes
    NerDLApproachHasInputAnnotationCols
  81. final val inputCols: StringArrayParam

    Permalink

    columns that contain annotations necessary to run this annotator AnnotatorType is used both as input and output columns if not specified

    columns that contain annotations necessary to run this annotator AnnotatorType is used both as input and output columns if not specified

    Attributes
    protected
    Definition Classes
    HasInputAnnotationCols
  82. final def isDefined(param: Param[_]): Boolean

    Permalink
    Definition Classes
    Params
  83. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  84. final def isSet(param: Param[_]): Boolean

    Permalink
    Definition Classes
    Params
  85. def isTraceEnabled(): Boolean

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  86. val labelColumn: Param[String]

    Permalink

    Column with label per each token

    Column with label per each token

    Definition Classes
    NerApproach
  87. val lazyAnnotator: BooleanParam

    Permalink
    Definition Classes
    CanBeLazy
  88. def log(value: ⇒ String, minLevel: Level): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  89. def log: Logger

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  90. def logDebug(msg: ⇒ String, throwable: Throwable): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  91. def logDebug(msg: ⇒ String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  92. def logError(msg: ⇒ String, throwable: Throwable): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  93. def logError(msg: ⇒ String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  94. def logInfo(msg: ⇒ String, throwable: Throwable): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  95. def logInfo(msg: ⇒ String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  96. def logName: String

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  97. def logTrace(msg: ⇒ String, throwable: Throwable): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  98. def logTrace(msg: ⇒ String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  99. def logWarning(msg: ⇒ String, throwable: Throwable): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  100. def logWarning(msg: ⇒ String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  101. val logger: Logger

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  102. val lr: FloatParam

    Permalink

    Learning Rate (Default: 1e-3f)

  103. val maxEpochs: IntParam

    Permalink

    Maximum number of epochs to train

    Maximum number of epochs to train

    Definition Classes
    NerApproach
  104. val minEpochs: IntParam

    Permalink

    Minimum number of epochs to train

    Minimum number of epochs to train

    Definition Classes
    NerApproach
  105. def msgHelper(schema: StructType): String

    Permalink
    Attributes
    protected
    Definition Classes
    HasInputAnnotationCols
  106. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  107. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  108. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  109. def onTrained(model: NerDLModel, spark: SparkSession): Unit

    Permalink
    Definition Classes
    AnnotatorApproach
  110. def onWrite(path: String, spark: SparkSession): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    ParamsAndFeaturesWritable
  111. val optionalInputAnnotatorTypes: Array[String]

    Permalink
    Definition Classes
    HasInputAnnotationCols
  112. val outputAnnotatorType: String

    Permalink

    Output annotator types: NAMED_ENTITY

    Output annotator types: NAMED_ENTITY

    Definition Classes
    NerDLApproachHasOutputAnnotatorType
  113. final val outputCol: Param[String]

    Permalink
    Attributes
    protected
    Definition Classes
    HasOutputAnnotationCol
  114. def outputLog(value: ⇒ String, uuid: String, shouldLog: Boolean, outputLogsPath: String): Unit

    Permalink
    Attributes
    protected
    Definition Classes
    Logging
  115. val outputLogsPath: Param[String]

    Permalink

    Folder path to save training logs (Default: "")

  116. lazy val params: Array[Param[_]]

    Permalink
    Definition Classes
    Params
  117. val po: FloatParam

    Permalink

    Learning rate decay coefficient (Default: 0.005f).

    Learning rate decay coefficient (Default: 0.005f). Real Learning Rate calculates to lr / (1 + po * epoch)

  118. val randomSeed: IntParam

    Permalink

    Random seed

    Random seed

    Definition Classes
    NerApproach
  119. def save(path: String): Unit

    Permalink
    Definition Classes
    MLWritable
    Annotations
    @Since( "1.6.0" ) @throws( ... )
  120. def set[T](feature: StructFeature[T], value: T): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  121. def set[K, V](feature: MapFeature[K, V], value: Map[K, V]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  122. def set[T](feature: SetFeature[T], value: Set[T]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  123. def set[T](feature: ArrayFeature[T], value: Array[T]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  124. final def set(paramPair: ParamPair[_]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  125. final def set(param: String, value: Any): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  126. final def set[T](param: Param[T], value: T): NerDLApproach.this.type

    Permalink
    Definition Classes
    Params
  127. def setBatchSize(batch: Int): NerDLApproach.this.type

    Permalink

    Batch size

  128. def setBestModelMetric(value: String): NerDLApproach.this.type

    Permalink

  129. def setConfigProtoBytes(bytes: Array[Int]): NerDLApproach.this.type

    Permalink

    ConfigProto from tensorflow, serialized into byte array.

    ConfigProto from tensorflow, serialized into byte array. Get with config_proto.SerializeToString()

  130. def setDefault[T](feature: StructFeature[T], value: () ⇒ T): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  131. def setDefault[K, V](feature: MapFeature[K, V], value: () ⇒ Map[K, V]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  132. def setDefault[T](feature: SetFeature[T], value: () ⇒ Set[T]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  133. def setDefault[T](feature: ArrayFeature[T], value: () ⇒ Array[T]): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    HasFeatures
  134. final def setDefault(paramPairs: ParamPair[_]*): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  135. final def setDefault[T](param: Param[T], value: T): NerDLApproach.this.type

    Permalink
    Attributes
    protected
    Definition Classes
    Params
  136. def setDropout(dropout: Float): NerDLApproach.this.type

    Permalink

    Dropout coefficient

  137. def setEnableMemoryOptimizer(value: Boolean): NerDLApproach.this.type

    Permalink

    Whether to optimize for large datasets or not.

    Whether to optimize for large datasets or not. Enabling this option can slow down training.

  138. def setEnableOutputLogs(enableOutputLogs: Boolean): NerDLApproach.this.type

    Permalink

    Whether to output to annotators log folder

  139. def setEntities(tags: Array[String]): NerDLApproach

    Permalink

    Entities to recognize

    Entities to recognize

    Definition Classes
    NerApproach
  140. def setEvaluationLogExtended(evaluationLogExtended: Boolean): NerDLApproach.this.type

    Permalink

    Whether logs for validation to be extended: it displays time and evaluation of each label.

    Whether logs for validation to be extended: it displays time and evaluation of each label. Default is false.

  141. def setGraphFolder(path: String): NerDLApproach.this.type

    Permalink

    Folder path that contain external graph files

  142. def setIncludeAllConfidenceScores(value: Boolean): NerDLApproach.this.type

    Permalink

    whether to include confidence scores for all tags rather than just for the predicted one

  143. def setIncludeConfidence(value: Boolean): NerDLApproach.this.type

    Permalink

    Whether to include confidence scores in annotation metadata

  144. final def setInputCols(value: String*): NerDLApproach.this.type

    Permalink
    Definition Classes
    HasInputAnnotationCols
  145. def setInputCols(value: Array[String]): NerDLApproach.this.type

    Permalink

    Overrides required annotators column if different than default

    Overrides required annotators column if different than default

    Definition Classes
    HasInputAnnotationCols
  146. def setLabelColumn(column: String): NerDLApproach

    Permalink

    Column with label per each token

    Column with label per each token

    Definition Classes
    NerApproach
  147. def setLazyAnnotator(value: Boolean): NerDLApproach.this.type

    Permalink
    Definition Classes
    CanBeLazy
  148. def setLr(lr: Float): NerDLApproach.this.type

    Permalink

    Learning Rate

  149. def setMaxEpochs(epochs: Int): NerDLApproach

    Permalink

    Maximum number of epochs to train

    Maximum number of epochs to train

    Definition Classes
    NerApproach
  150. def setMinEpochs(epochs: Int): NerDLApproach

    Permalink

    Minimum number of epochs to train

    Minimum number of epochs to train

    Definition Classes
    NerApproach
  151. final def setOutputCol(value: String): NerDLApproach.this.type

    Permalink

    Overrides annotation column name when transforming

    Overrides annotation column name when transforming

    Definition Classes
    HasOutputAnnotationCol
  152. def setOutputLogsPath(path: String): NerDLApproach.this.type

    Permalink

    Folder path to save training logs

  153. def setPo(po: Float): NerDLApproach.this.type

    Permalink

    Learning rate decay coefficient.

    Learning rate decay coefficient. Real Learning Rage = lr / (1 + po * epoch)

  154. def setRandomSeed(seed: Int): NerDLApproach

    Permalink

    Random seed

    Random seed

    Definition Classes
    NerApproach
  155. def setTestDataset(er: ExternalResource): NerDLApproach.this.type

    Permalink

    Path to test dataset.

    Path to test dataset. If set, it is used to calculate statistics on it during training.

  156. def setTestDataset(path: String, readAs: Format = ReadAs.SPARK, options: Map[String, String] = Map("format" -> "parquet")): NerDLApproach.this.type

    Permalink

    Path to test dataset.

    Path to test dataset. If set, it is used to calculate statistics on it during training.

  157. def setUseBestModel(value: Boolean): NerDLApproach.this.type

    Permalink

  158. def setUseContrib(value: Boolean): NerDLApproach.this.type

    Permalink

    Whether to use contrib LSTM Cells.

    Whether to use contrib LSTM Cells. Not compatible with Windows. Might slightly improve accuracy.

  159. def setValidationSplit(validationSplit: Float): NerDLApproach.this.type

    Permalink

    Choose the proportion of training dataset to be validated against the model on each Epoch.

    Choose the proportion of training dataset to be validated against the model on each Epoch. The value should be between 0.0 and 1.0 and by default it is 0.0 and off.

  160. def setVerbose(verbose: Level): NerDLApproach

    Permalink

    Level of verbosity during training

    Level of verbosity during training

    Definition Classes
    NerApproach
  161. def setVerbose(verbose: Int): NerDLApproach

    Permalink

    Level of verbosity during training

    Level of verbosity during training

    Definition Classes
    NerApproach
  162. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  163. val testDataset: ExternalResourceParam

    Permalink

    Path to test dataset.

    Path to test dataset. If set, it is used to calculate statistics on it during training.

  164. def toString(): String

    Permalink
    Definition Classes
    Identifiable → AnyRef → Any
  165. def train(dataset: Dataset[_], recursivePipeline: Option[PipelineModel]): NerDLModel

    Permalink
    Definition Classes
    NerDLApproachAnnotatorApproach
  166. final def transformSchema(schema: StructType): StructType

    Permalink

    requirement for pipeline transformation validation.

    requirement for pipeline transformation validation. It is called on fit()

    Definition Classes
    AnnotatorApproach → PipelineStage
  167. def transformSchema(schema: StructType, logging: Boolean): StructType

    Permalink
    Attributes
    protected
    Definition Classes
    PipelineStage
    Annotations
    @DeveloperApi()
  168. val uid: String

    Permalink

    required uid for storing annotator to disk

    required uid for storing annotator to disk

    Definition Classes
    NerDLApproach → Identifiable
  169. val useBestModel: BooleanParam

    Permalink

    Whether to restore and use the model that has achieved the best performance at the end of the training.

    Whether to restore and use the model that has achieved the best performance at the end of the training. The metric that is being monitored is F1 for testDataset and if it's not set it will be validationSplit, and if it's not set finally looks for loss.

  170. val useContrib: BooleanParam

    Permalink

    Whether to use contrib LSTM Cells (Default: true).

    Whether to use contrib LSTM Cells (Default: true). Not compatible with Windows. Might slightly improve accuracy. This param is deprecated and only exists for backward compatibility

  171. def validate(schema: StructType): Boolean

    Permalink

    takes a Dataset and checks to see if all the required annotation types are present.

    takes a Dataset and checks to see if all the required annotation types are present.

    schema

    to be validated

    returns

    True if all the required types are present, else false

    Attributes
    protected
    Definition Classes
    AnnotatorApproach
  172. val validationSplit: FloatParam

    Permalink

    Choose the proportion of training dataset to be validated against the model on each Epoch (Default: 0.0f).

    Choose the proportion of training dataset to be validated against the model on each Epoch (Default: 0.0f). The value should be between 0.0 and 1.0 and by default it is 0.0 and off.

  173. val verbose: IntParam

    Permalink

    Level of verbosity during training (Default: Verbose.Silent.id)

    Level of verbosity during training (Default: Verbose.Silent.id)

    Definition Classes
    NerApproach
  174. val verboseLevel: Level

    Permalink
    Definition Classes
    NerDLApproachLogging
  175. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  176. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  177. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  178. def write: MLWriter

    Permalink
    Definition Classes
    ParamsAndFeaturesWritable → DefaultParamsWritable → MLWritable

Inherited from ParamsAndFeaturesWritable

Inherited from HasFeatures

Inherited from Logging

Inherited from NerApproach[NerDLApproach]

Inherited from AnnotatorApproach[NerDLModel]

Inherited from CanBeLazy

Inherited from DefaultParamsWritable

Inherited from MLWritable

Inherited from HasOutputAnnotatorType

Inherited from HasOutputAnnotationCol

Inherited from HasInputAnnotationCols

Inherited from Estimator[NerDLModel]

Inherited from PipelineStage

Inherited from Logging

Inherited from Params

Inherited from Serializable

Inherited from Serializable

Inherited from Identifiable

Inherited from AnyRef

Inherited from Any

Parameters

A list of (hyper-)parameter keys this annotator can take. Users can set and get the parameter values through setters and getters, respectively.

Annotator types

Required input and expected output annotator types

Members

Parameter setters

Parameter getters