class LayoutAlignerForText extends Transformer with HasInputAnnotationCols with HasOutputAnnotationCol with DefaultParamsWritable
LayoutAlignerForText rebuilds final text by combining document chunks and generated image captions produced by multimodal models.
It is designed to consume aligned_doc + image_caption pairs (for example, after
LayoutAlignerForVision + AutoGGUFVisionModel) and emit a coherent document where captions
are inserted around their best matching text blocks.
DISCLAIMER: By default, input columns (aligned_doc, image_caption) are not preserved. This
stage groups and can explode rows while rebuilding text, so input row cardinality does not
reliably match output row cardinality. Keeping passthrough inputs in that mode can produce
misleading repeated values. Set preserveColumns = true to try to keep grouped input
annotations when you explicitly need them for inspection.
- Alphabetic
- By Inheritance
- LayoutAlignerForText
- DefaultParamsWritable
- MLWritable
- HasOutputAnnotationCol
- HasInputAnnotationCols
- Transformer
- PipelineStage
- Logging
- Params
- Serializable
- Serializable
- Identifiable
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Instance Constructors
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
$[T](param: Param[T]): T
- Attributes
- protected
- Definition Classes
- Params
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
final
def
checkSchema(schema: StructType, inputAnnotatorType: String): Boolean
- Attributes
- protected
- Definition Classes
- HasInputAnnotationCols
-
final
def
clear(param: Param[_]): LayoutAlignerForText.this.type
- Definition Classes
- Params
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
def
copy(extra: ParamMap): Transformer
Standard Spark ML copy implementation.
Standard Spark ML copy implementation.
- Definition Classes
- LayoutAlignerForText → Transformer → PipelineStage → Params
-
def
copyValues[T <: Params](to: T, extra: ParamMap): T
- Attributes
- protected
- Definition Classes
- Params
-
final
def
defaultCopy[T <: Params](extra: ParamMap): T
- Attributes
- protected
- Definition Classes
- Params
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
explainParam(param: Param[_]): String
- Definition Classes
- Params
-
def
explainParams(): String
- Definition Classes
- Params
-
val
explodeElements: BooleanParam
Controls row emission mode.
Controls row emission mode.
When
true, one output row is emitted per aligned element. Whenfalse, one output row is emitted per file with a single merged document annotation. -
final
val
extraInputCols: StringArrayParam
- Attributes
- protected
- Definition Classes
- HasInputAnnotationCols
-
final
def
extractParamMap(): ParamMap
- Definition Classes
- Params
-
final
def
extractParamMap(extra: ParamMap): ParamMap
- Definition Classes
- Params
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
get[T](param: Param[T]): Option[T]
- Definition Classes
- Params
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
final
def
getDefault[T](param: Param[T]): Option[T]
- Definition Classes
- Params
-
def
getInputCols: Array[String]
- returns
input annotations columns currently used
- Definition Classes
- HasInputAnnotationCols
-
final
def
getOrDefault[T](param: Param[T]): T
- Definition Classes
- Params
-
final
def
getOutputCol: String
Gets annotation column name going to generate
Gets annotation column name going to generate
- Definition Classes
- HasOutputAnnotationCol
-
def
getParam(paramName: String): Param[Any]
- Definition Classes
- Params
-
final
def
hasDefault[T](param: Param[T]): Boolean
- Definition Classes
- Params
-
def
hasParam(paramName: String): Boolean
- Definition Classes
- Params
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
initializeLogIfNecessary(isInterpreter: Boolean, silent: Boolean): Boolean
- Attributes
- protected
- Definition Classes
- Logging
-
def
initializeLogIfNecessary(isInterpreter: Boolean): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
val
inlinePrefixThreshold: IntParam
Threshold used to decide if inline captions should be prefixed before paragraph text.
-
val
inputAnnotatorTypes: Array[String]
This stage consumes two DOCUMENT inputs: aligned text chunks and generated captions.
This stage consumes two DOCUMENT inputs: aligned text chunks and generated captions.
- Definition Classes
- LayoutAlignerForText → HasInputAnnotationCols
-
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
-
final
def
isDefined(param: Param[_]): Boolean
- Definition Classes
- Params
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
final
def
isSet(param: Param[_]): Boolean
- Definition Classes
- Params
-
def
isTraceEnabled(): Boolean
- Attributes
- protected
- Definition Classes
- Logging
-
val
joinDelimiter: Param[String]
Delimiter used when joining text/caption pieces into one rebuilt element string.
-
def
log: Logger
- Attributes
- protected
- Definition Classes
- Logging
-
def
logDebug(msg: ⇒ String, throwable: Throwable): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logDebug(msg: ⇒ String): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logError(msg: ⇒ String, throwable: Throwable): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logError(msg: ⇒ String): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logInfo(msg: ⇒ String, throwable: Throwable): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logInfo(msg: ⇒ String): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logName: String
- Attributes
- protected
- Definition Classes
- Logging
-
def
logTrace(msg: ⇒ String, throwable: Throwable): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logTrace(msg: ⇒ String): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logWarning(msg: ⇒ String, throwable: Throwable): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
logWarning(msg: ⇒ String): Unit
- Attributes
- protected
- Definition Classes
- Logging
-
def
msgHelper(schema: StructType): String
- Attributes
- protected
- Definition Classes
- HasInputAnnotationCols
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
val
optionalInputAnnotatorTypes: Array[String]
- Definition Classes
- HasInputAnnotationCols
-
final
val
outputCol: Param[String]
- Attributes
- protected
- Definition Classes
- HasOutputAnnotationCol
-
lazy val
params: Array[Param[_]]
- Definition Classes
- Params
-
val
preserveColumns: BooleanParam
Controls whether input annotation columns are preserved in the final output.
Controls whether input annotation columns are preserved in the final output.
When
true, input columns are preserved by aggregating all original input annotation rows that contributed to a rebuilt group. Whenfalse, input annotation columns are dropped sooutputColis the authoritative text output and stale passthrough values are avoided. -
def
save(path: String): Unit
- Definition Classes
- MLWritable
- Annotations
- @Since( "1.6.0" ) @throws( ... )
-
final
def
set(paramPair: ParamPair[_]): LayoutAlignerForText.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
set(param: String, value: Any): LayoutAlignerForText.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
set[T](param: Param[T], value: T): LayoutAlignerForText.this.type
- Definition Classes
- Params
-
final
def
setDefault(paramPairs: ParamPair[_]*): LayoutAlignerForText.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
setDefault[T](param: Param[T], value: T): LayoutAlignerForText.this.type
- Attributes
- protected[org.apache.spark.ml]
- Definition Classes
- Params
-
def
setExplodeElements(value: Boolean): LayoutAlignerForText.this.type
Enables/disables one-row-per-element output mode.
-
def
setExtraInputCols(value: Array[String]): LayoutAlignerForText.this.type
- Definition Classes
- HasInputAnnotationCols
-
def
setInlinePrefixThreshold(value: Int): LayoutAlignerForText.this.type
Sets the inline X threshold for prefix insertion.
-
final
def
setInputCols(value: String*): LayoutAlignerForText.this.type
- Definition Classes
- HasInputAnnotationCols
-
def
setInputCols(value: Array[String]): LayoutAlignerForText.this.type
Overrides required annotators column if different than default
Overrides required annotators column if different than default
- Definition Classes
- HasInputAnnotationCols
-
def
setJoinDelimiter(value: String): LayoutAlignerForText.this.type
Sets the delimiter used between rebuilt pieces.
-
final
def
setOutputCol(value: String): LayoutAlignerForText.this.type
Overrides annotation column name when transforming
Overrides annotation column name when transforming
- Definition Classes
- HasOutputAnnotationCol
-
def
setPreserveColumns(value: Boolean): LayoutAlignerForText.this.type
Enables/disables preservation of input annotation columns.
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- Identifiable → AnyRef → Any
-
def
transform(dataset: Dataset[_]): DataFrame
Executes the transformation: 1) validate schema and resolve input columns 2) aggregate
(aligned_doc, image_caption)pairs 3) rebuild coherent text blocks 4) optionally preserve original input columns 5) re-attach Spark NLP annotation metadataExecutes the transformation: 1) validate schema and resolve input columns 2) aggregate
(aligned_doc, image_caption)pairs 3) rebuild coherent text blocks 4) optionally preserve original input columns 5) re-attach Spark NLP annotation metadata- Definition Classes
- LayoutAlignerForText → Transformer
-
def
transform(dataset: Dataset[_], paramMap: ParamMap): DataFrame
- Definition Classes
- Transformer
- Annotations
- @Since( "2.0.0" )
-
def
transform(dataset: Dataset[_], firstParamPair: ParamPair[_], otherParamPairs: ParamPair[_]*): DataFrame
- Definition Classes
- Transformer
- Annotations
- @Since( "2.0.0" ) @varargs()
-
def
transformSchema(schema: StructType): StructType
Computes the output schema:
Computes the output schema:
- always adds/overwrites
outputColas DOCUMENT annotations - drops input annotation columns unless
preserveColumns=true
- Definition Classes
- LayoutAlignerForText → PipelineStage
- always adds/overwrites
-
def
transformSchema(schema: StructType, logging: Boolean): StructType
- Attributes
- protected
- Definition Classes
- PipelineStage
- Annotations
- @DeveloperApi()
-
val
uid: String
- Definition Classes
- LayoutAlignerForText → Identifiable
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
def
write: MLWriter
- Definition Classes
- DefaultParamsWritable → MLWritable