Packages

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

NerCrfApproach for a generic CRF approach

NerConverter to further process the results

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()
  2. new NerDLApproach(uid: String)

    uid

    required uid for storing annotator to disk

Type Members

  1. type AnnotatorType = String
    Definition Classes
    HasOutputAnnotatorType

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def $[T](param: Param[T]): T
    Attributes
    protected
    Definition Classes
    Params
  4. def $$[T](feature: StructFeature[T]): T
    Attributes
    protected
    Definition Classes
    HasFeatures
  5. def $$[K, V](feature: MapFeature[K, V]): Map[K, V]
    Attributes
    protected
    Definition Classes
    HasFeatures
  6. def $$[T](feature: SetFeature[T]): Set[T]
    Attributes
    protected
    Definition Classes
    HasFeatures
  7. def $$[T](feature: ArrayFeature[T]): Array[T]
    Attributes
    protected
    Definition Classes
    HasFeatures
  8. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  9. def _fit(dataset: Dataset[_], recursiveStages: Option[PipelineModel]): NerDLModel
    Attributes
    protected
    Definition Classes
    AnnotatorApproach
  10. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  11. val batchSize: IntParam

    Batch size (Default: 8)

  12. def beforeTraining(spark: SparkSession): Unit
    Definition Classes
    NerDLApproachAnnotatorApproach
  13. val bestModelMetric: Param[String]

    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
  15. final def checkSchema(schema: StructType, inputAnnotatorType: String): Boolean
    Attributes
    protected
    Definition Classes
    HasInputAnnotationCols
  16. final def clear(param: Param[_]): NerDLApproach.this.type
    Definition Classes
    Params
  17. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  18. val configProtoBytes: IntArrayParam

    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]
    Definition Classes
    AnnotatorApproach → Estimator → PipelineStage → Params
  20. def copyValues[T <: Params](to: T, extra: ParamMap): T
    Attributes
    protected
    Definition Classes
    Params
  21. final def defaultCopy[T <: Params](extra: ParamMap): T
    Attributes
    protected
    Definition Classes
    Params
  22. val description: String

    Trains Tensorflow based Char-CNN-BLSTM model

    Trains Tensorflow based Char-CNN-BLSTM model

    Definition Classes
    NerDLApproachAnnotatorApproach
  23. val dropout: FloatParam

    Dropout coefficient (Default: 0.5f)

  24. val enableMemoryOptimizer: BooleanParam

    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

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

  26. val entities: StringArrayParam

    Entities to recognize

    Entities to recognize

    Definition Classes
    NerApproach
  27. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  28. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  29. val evaluationLogExtended: BooleanParam

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

  30. def explainParam(param: Param[_]): String
    Definition Classes
    Params
  31. def explainParams(): String
    Definition Classes
    Params
  32. final def extractParamMap(): ParamMap
    Definition Classes
    Params
  33. final def extractParamMap(extra: ParamMap): ParamMap
    Definition Classes
    Params
  34. val features: ArrayBuffer[Feature[_, _, _]]
    Definition Classes
    HasFeatures
  35. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  36. final def fit(dataset: Dataset[_]): NerDLModel
    Definition Classes
    AnnotatorApproach → Estimator
  37. def fit(dataset: Dataset[_], paramMaps: Array[ParamMap]): Seq[NerDLModel]
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" )
  38. def fit(dataset: Dataset[_], paramMap: ParamMap): NerDLModel
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" )
  39. def fit(dataset: Dataset[_], firstParamPair: ParamPair[_], otherParamPairs: ParamPair[_]*): NerDLModel
    Definition Classes
    Estimator
    Annotations
    @Since( "2.0.0" ) @varargs()
  40. def get[T](feature: StructFeature[T]): Option[T]
    Attributes
    protected
    Definition Classes
    HasFeatures
  41. def get[K, V](feature: MapFeature[K, V]): Option[Map[K, V]]
    Attributes
    protected
    Definition Classes
    HasFeatures
  42. def get[T](feature: SetFeature[T]): Option[Set[T]]
    Attributes
    protected
    Definition Classes
    HasFeatures
  43. def get[T](feature: ArrayFeature[T]): Option[Array[T]]
    Attributes
    protected
    Definition Classes
    HasFeatures
  44. final def get[T](param: Param[T]): Option[T]
    Definition Classes
    Params
  45. def getBatchSize: Int

    Batch size

  46. def getBestModelMetric: String

  47. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  48. def getConfigProtoBytes: Option[Array[Byte]]

    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)
  50. final def getDefault[T](param: Param[T]): Option[T]
    Definition Classes
    Params
  51. def getDropout: Float

    Dropout coefficient

  52. def getEnableMemoryOptimizer: Boolean

    Memory Optimizer

  53. def getEnableOutputLogs: Boolean

    Whether to output to annotators log folder

  54. def getIncludeConfidence: Boolean

    whether to include confidence scores in annotation metadata

  55. def getInputCols: Array[String]

    returns

    input annotations columns currently used

    Definition Classes
    HasInputAnnotationCols
  56. def getIteratorFunc(dataset: Dataset[Row]): () ⇒ Iterator[Array[(TextSentenceLabels, WordpieceEmbeddingsSentence)]]
  57. def getLazyAnnotator: Boolean
    Definition Classes
    CanBeLazy
  58. def getLogName: String
    Definition Classes
    NerDLApproachLogging
  59. def getLr: Float

    Learning Rate

  60. def getMaxEpochs: Int

    Maximum number of epochs to train

    Maximum number of epochs to train

    Definition Classes
    NerApproach
  61. def getMinEpochs: Int

    Minimum number of epochs to train

    Minimum number of epochs to train

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

    Gets annotation column name going to generate

    Gets annotation column name going to generate

    Definition Classes
    HasOutputAnnotationCol
  64. def getOutputLogsPath: String

    Folder path to save training logs

  65. def getParam(paramName: String): Param[Any]
    Definition Classes
    Params
  66. def getPo: Float

    Learning rate decay coefficient.

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

  67. def getRandomSeed: Int

    Random seed

    Random seed

    Definition Classes
    NerApproach
  68. def getUseBestModel: Boolean

    useBestModel

  69. def getUseContrib: Boolean

    Whether to use contrib LSTM Cells.

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

  70. def getValidationSplit: Float

    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

    Level of verbosity during training

    Level of verbosity during training

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

    Folder path that contain external graph files

  73. final def hasDefault[T](param: Param[T]): Boolean
    Definition Classes
    Params
  74. def hasParam(paramName: String): Boolean
    Definition Classes
    Params
  75. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  76. val includeAllConfidenceScores: BooleanParam

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

  77. val includeConfidence: BooleanParam

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

  78. def initializeLogIfNecessary(isInterpreter: Boolean, silent: Boolean): Boolean
    Attributes
    protected
    Definition Classes
    Logging
  79. def initializeLogIfNecessary(isInterpreter: Boolean): Unit
    Attributes
    protected
    Definition Classes
    Logging
  80. val inputAnnotatorTypes: Array[String]

    Input annotator types: DOCUMENT, TOKEN, WORD_EMBEDDINGS

    Input annotator types: DOCUMENT, TOKEN, WORD_EMBEDDINGS

    Definition Classes
    NerDLApproachHasInputAnnotationCols
  81. final val inputCols: StringArrayParam

    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
    Definition Classes
    Params
  83. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  84. final def isSet(param: Param[_]): Boolean
    Definition Classes
    Params
  85. def isTraceEnabled(): Boolean
    Attributes
    protected
    Definition Classes
    Logging
  86. val labelColumn: Param[String]

    Column with label per each token

    Column with label per each token

    Definition Classes
    NerApproach
  87. val lazyAnnotator: BooleanParam
    Definition Classes
    CanBeLazy
  88. def log(value: ⇒ String, minLevel: Level): Unit
    Attributes
    protected
    Definition Classes
    Logging
  89. def log: Logger
    Attributes
    protected
    Definition Classes
    Logging
  90. def logDebug(msg: ⇒ String, throwable: Throwable): Unit
    Attributes
    protected
    Definition Classes
    Logging
  91. def logDebug(msg: ⇒ String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  92. def logError(msg: ⇒ String, throwable: Throwable): Unit
    Attributes
    protected
    Definition Classes
    Logging
  93. def logError(msg: ⇒ String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  94. def logInfo(msg: ⇒ String, throwable: Throwable): Unit
    Attributes
    protected
    Definition Classes
    Logging
  95. def logInfo(msg: ⇒ String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  96. def logName: String
    Attributes
    protected
    Definition Classes
    Logging
  97. def logTrace(msg: ⇒ String, throwable: Throwable): Unit
    Attributes
    protected
    Definition Classes
    Logging
  98. def logTrace(msg: ⇒ String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  99. def logWarning(msg: ⇒ String, throwable: Throwable): Unit
    Attributes
    protected
    Definition Classes
    Logging
  100. def logWarning(msg: ⇒ String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  101. val logger: Logger
    Attributes
    protected
    Definition Classes
    Logging
  102. val lr: FloatParam

    Learning Rate (Default: 1e-3f)

  103. val maxEpochs: IntParam

    Maximum number of epochs to train

    Maximum number of epochs to train

    Definition Classes
    NerApproach
  104. val minEpochs: IntParam

    Minimum number of epochs to train

    Minimum number of epochs to train

    Definition Classes
    NerApproach
  105. def msgHelper(schema: StructType): String
    Attributes
    protected
    Definition Classes
    HasInputAnnotationCols
  106. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  107. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  108. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  109. def onTrained(model: NerDLModel, spark: SparkSession): Unit
    Definition Classes
    AnnotatorApproach
  110. def onWrite(path: String, spark: SparkSession): Unit
    Attributes
    protected
    Definition Classes
    ParamsAndFeaturesWritable
  111. val optionalInputAnnotatorTypes: Array[String]
    Definition Classes
    HasInputAnnotationCols
  112. val outputAnnotatorType: String

    Output annotator types: NAMED_ENTITY

    Output annotator types: NAMED_ENTITY

    Definition Classes
    NerDLApproachHasOutputAnnotatorType
  113. final val outputCol: Param[String]
    Attributes
    protected
    Definition Classes
    HasOutputAnnotationCol
  114. def outputLog(value: ⇒ String, uuid: String, shouldLog: Boolean, outputLogsPath: String): Unit
    Attributes
    protected
    Definition Classes
    Logging
  115. val outputLogsPath: Param[String]

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

  116. lazy val params: Array[Param[_]]
    Definition Classes
    Params
  117. val po: FloatParam

    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

    Random seed

    Random seed

    Definition Classes
    NerApproach
  119. def save(path: String): Unit
    Definition Classes
    MLWritable
    Annotations
    @Since( "1.6.0" ) @throws( ... )
  120. def set[T](feature: StructFeature[T], value: T): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  121. def set[K, V](feature: MapFeature[K, V], value: Map[K, V]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  122. def set[T](feature: SetFeature[T], value: Set[T]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  123. def set[T](feature: ArrayFeature[T], value: Array[T]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  124. final def set(paramPair: ParamPair[_]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    Params
  125. final def set(param: String, value: Any): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    Params
  126. final def set[T](param: Param[T], value: T): NerDLApproach.this.type
    Definition Classes
    Params
  127. def setBatchSize(batch: Int): NerDLApproach.this.type

    Batch size

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

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

    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
    Attributes
    protected
    Definition Classes
    HasFeatures
  131. def setDefault[K, V](feature: MapFeature[K, V], value: () ⇒ Map[K, V]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  132. def setDefault[T](feature: SetFeature[T], value: () ⇒ Set[T]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  133. def setDefault[T](feature: ArrayFeature[T], value: () ⇒ Array[T]): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    HasFeatures
  134. final def setDefault(paramPairs: ParamPair[_]*): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    Params
  135. final def setDefault[T](param: Param[T], value: T): NerDLApproach.this.type
    Attributes
    protected
    Definition Classes
    Params
  136. def setDropout(dropout: Float): NerDLApproach.this.type

    Dropout coefficient

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

    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

    Whether to output to annotators log folder

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

    Entities to recognize

    Entities to recognize

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

    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

    Folder path that contain external graph files

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

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

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

    Whether to include confidence scores in annotation metadata

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

    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

    Column with label per each token

    Column with label per each token

    Definition Classes
    NerApproach
  147. def setLazyAnnotator(value: Boolean): NerDLApproach.this.type
    Definition Classes
    CanBeLazy
  148. def setLr(lr: Float): NerDLApproach.this.type

    Learning Rate

  149. def setMaxEpochs(epochs: Int): NerDLApproach

    Maximum number of epochs to train

    Maximum number of epochs to train

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

    Minimum number of epochs to train

    Minimum number of epochs to train

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

    Overrides annotation column name when transforming

    Overrides annotation column name when transforming

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

    Folder path to save training logs

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

    Learning rate decay coefficient.

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

  154. def setRandomSeed(seed: Int): NerDLApproach

    Random seed

    Random seed

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

    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

    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

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

    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

    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

    Level of verbosity during training

    Level of verbosity during training

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

    Level of verbosity during training

    Level of verbosity during training

    Definition Classes
    NerApproach
  162. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  163. val testDataset: ExternalResourceParam

    Path to test dataset.

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

  164. def toString(): String
    Definition Classes
    Identifiable → AnyRef → Any
  165. def train(dataset: Dataset[_], recursivePipeline: Option[PipelineModel]): NerDLModel
    Definition Classes
    NerDLApproachAnnotatorApproach
  166. final def transformSchema(schema: StructType): StructType

    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
    Attributes
    protected
    Definition Classes
    PipelineStage
    Annotations
    @DeveloperApi()
  168. val uid: String
    Definition Classes
    NerDLApproach → Identifiable
  169. val useBestModel: BooleanParam

    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

    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

    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

    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

    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
    Definition Classes
    NerDLApproachLogging
  175. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  176. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  177. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  178. def write: MLWriter
    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