com.johnsnowlabs.nlp.annotators.deid.fhir
FhirDeIdentification
Companion object FhirDeIdentification
class FhirDeIdentification extends Transformer with HasFeatures with LightDeIdentificationParams with DeidModelParams with CheckLicense with HasInputCol with HasOutputAnnotationCol with ParamsAndFeaturesWritable
A Spark Transformer for de-identifying FHIR resources according to configurable privacy rules.
Overview
Performs field-level obfuscation on FHIR JSON documents using FHIR Path expressions. Supports R4, R5, and DSTU3 FHIR versions with type-aware de-identification strategies. Additionally, supports different parser types (JSON, XML) for FHIR resources.
Basic Pipeline Usage
val deid = new FhirDeIdentification() .setInputCol("raw_fhir") .setOutputCol("deidentified") .setMode("obfuscate") .setMappingRules(Map("Patient.birthDate" -> "Date")) val pipeline = new Pipeline().setStages(Array(deid))
- See also
- Grouped
- Alphabetic
- By Inheritance
- FhirDeIdentification
- ParamsAndFeaturesWritable
- DefaultParamsWritable
- MLWritable
- HasOutputAnnotationCol
- HasInputCol
- CheckLicense
- DeidModelParams
- LightDeIdentificationParams
- MaskingParams
- BaseDeidParams
- HasFeatures
- 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
-
def
$$[T](feature: StructFeature[T]): T
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
$$[K, V](feature: MapFeature[K, V]): Map[K, V]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
$$[T](feature: SetFeature[T]): Set[T]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
$$[T](feature: ArrayFeature[T]): Array[T]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
val
GEOGRAPHIC_ENTITIES_PRIORITY: Map[String, Int]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
GEO_METADATA_KEY: String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
additionalDateFormats: StringArrayParam
Additional date formats to be considered during date obfuscation.
Additional date formats to be considered during date obfuscation. This allows users to specify custom date formats in addition to the default dateFormats.
- Definition Classes
- BaseDeidParams
-
val
ageRanges: IntArrayParam
List of integers specifying limits of the age groups to preserve during obfuscation
List of integers specifying limits of the age groups to preserve during obfuscation
- Definition Classes
- BaseDeidParams
-
val
ageRangesByHipaa: BooleanParam
A Boolean variable indicating whether to obfuscate ages based on HIPAA (Health Insurance Portability and Accountability Act) Privacy Rule.
A Boolean variable indicating whether to obfuscate ages based on HIPAA (Health Insurance Portability and Accountability Act) Privacy Rule.
The HIPAA Privacy Rule mandates that ages from patients older than 90 years must be obfuscated, while age for patients 90 years or younger can remain unchanged.
When
true
, age entities larger than 90 will be obfuscated as per HIPAA Privacy Rule, the others will remain unchanged. Whenfalse
, ageRanges parameter is valid.- Definition Classes
- BaseDeidParams
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
checkValidEnvironment(spark: Option[SparkSession], scopes: Seq[String]): Unit
- Definition Classes
- CheckLicense
-
def
checkValidScope(scope: String): Unit
- Definition Classes
- CheckLicense
-
def
checkValidScopeAndEnvironment(scope: String, spark: Option[SparkSession], checkLp: Boolean): Unit
- Definition Classes
- CheckLicense
-
def
checkValidScopesAndEnvironment(scopes: Seq[String], spark: Option[SparkSession], checkLp: Boolean): Unit
- Definition Classes
- CheckLicense
-
final
def
clear(param: Param[_]): FhirDeIdentification.this.type
- Definition Classes
- Params
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
lazy val
combinedDateFormats: Array[String]
- Attributes
- protected
- Definition Classes
- BaseDeidParams
-
val
consistentAcrossNameParts: BooleanParam
Param that indicates whether consistency should be enforced across different parts of a name (e.g., first name, middle name, last name).
Param that indicates whether consistency should be enforced across different parts of a name (e.g., first name, middle name, last name). When set to
true
, the same transformation or obfuscation will be applied consistently to all parts of the same name entity, even if those parts appear separately.For example, if "John Smith" is obfuscated as "Liam Brown", then:
- When the full name "John Smith" appears, it will be replaced with "Liam Brown"
- When "John" or "Smith" appear individually, they will still be obfuscated as "Liam" and "Brown" respectively, ensuring consistency in name transformation.
Default: true
- Definition Classes
- BaseDeidParams
-
def
copy(extra: ParamMap): FhirDeIdentification
- Definition Classes
- FhirDeIdentification → Transformer → PipelineStage → Params
-
def
copyValues[T <: Params](to: T, extra: ParamMap): T
- Attributes
- protected
- Definition Classes
- Params
-
val
countryObfuscation: BooleanParam
Whether to obfuscate country entities or not.
Whether to obfuscate country entities or not. If true, country entities will be obfuscated using the Faker module. If false, country entities will be skipped during obfuscation. Default: false
- Definition Classes
- BaseDeidParams
-
val
customFakers: MapFeature[String, Array[String]]
The dictionary of custom fakers to specify the obfuscation terms for the entities.
The dictionary of custom fakers to specify the obfuscation terms for the entities. You can specify the entity and the terms to be used for obfuscation.
- Definition Classes
- LightDeIdentificationParams
-
val
dateEntities: StringArrayParam
List of date entities.
List of date entities. Default: Array("DATE", "DOB", "DOD", "EFFDATE", "FISCAL_YEAR")
- Definition Classes
- BaseDeidParams
-
val
dateFormats: StringArrayParam
Format of dates to displace
Format of dates to displace
- Definition Classes
- BaseDeidParams
-
val
days: IntParam
Number of days to obfuscate the dates by displacement.
Number of days to obfuscate the dates by displacement. If not provided a random integer between 1 and 60 will be used
- Definition Classes
- BaseDeidParams
-
final
def
defaultCopy[T <: Params](extra: ParamMap): T
- Attributes
- protected
- Definition Classes
- Params
-
def
deidentify(jsonStr: String, rules: Map[String, String]): String
- Attributes
- protected
- def deidentify(jsonStr: String): String
- def deidentify_list(jsonStrs: ArrayList[String]): List[String]
- def deidentify_list(jsonStrs: Array[String]): Array[String]
-
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
-
final
def
extractParamMap(): ParamMap
- Definition Classes
- Params
-
final
def
extractParamMap(extra: ParamMap): ParamMap
- Definition Classes
- Params
-
val
fakerLengthOffset: IntParam
It specifies how much length deviation is accepted in obfuscation, with keepTextSizeForObfuscation enabled.
It specifies how much length deviation is accepted in obfuscation, with keepTextSizeForObfuscation enabled. Value must be greater than 0. Default is 3.
- Definition Classes
- BaseDeidParams
-
val
features: ArrayBuffer[Feature[_, _, _]]
- Definition Classes
- HasFeatures
-
val
fhirVersion: Param[String]
Set FHIR version to de-identify.
Set FHIR version to de-identify. Supported versions are "). Default is R4.
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
val
fixedMaskLength: IntParam
Select the fixed mask length: this is the length of the masking sequence that will be used when the 'fixed_length_chars' masking policy is selected.
Select the fixed mask length: this is the length of the masking sequence that will be used when the 'fixed_length_chars' masking policy is selected.
- Definition Classes
- MaskingParams
-
val
genderAwareness: BooleanParam
Whether to use gender-aware names or not during obfuscation.
Whether to use gender-aware names or not during obfuscation. This param effects only names. If value is true, it might decrease performance. Default: False
- Definition Classes
- BaseDeidParams
-
def
generateFakeBySameLength(wordToReplace: String, entity: String): String
obfuscating digits to new digits, letters to new letters and others remains the same
obfuscating digits to new digits, letters to new letters and others remains the same
- Definition Classes
- DeidModelParams
-
def
generateFakeBySameLengthUsingHash(wordToReplace: String, entity: String): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
geoConsistency: BooleanParam
Whether to enforce consistent obfuscation across geographical entities: state, city, street, zip and phone.
Whether to enforce consistent obfuscation across geographical entities: state, city, street, zip and phone.
## Functionality Overview This parameter enables intelligent geographical entity obfuscation that maintains realistic relationships between different geographic components. When enabled, the system ensures that obfuscated addresses form coherent, valid combinations rather than random replacements.
## Supported Entity Types The following geographical entities are processed with priority order: - **state** (Priority: 0) - US state names - **city** (Priority: 1) - City names - **zip** (Priority: 2) - Zip codes - **street** (Priority: 3) - Street addresses - **phone** (Priority: 4) - Phone numbers
## Language Requirement **IMPORTANT**: Geographic consistency is only applied when: -
geoConsistency
parameter is set totrue
AND -language
parameter is set toen
For non-English configurations, this feature is automatically disabled regardless of the parameter setting.
## Consistency Algorithm When geographical entities comes from the chunk columns:
1. **Entity Grouping**: All geographic entities are identified and grouped by type 2. **Fake Address Selection**: A consistent set of fake US addresses is selected using hash-based deterministic selection to ensure reproducibility 3. **Priority-Based Mapping**: Entities are mapped to fake addresses following the priority order (state → city → zip → street → phone) 4. **Consistent Replacement**: All entities of the same type within a document use the same fake address pool, maintaining geographical coherence
## Parameter Interactions **IMPORTANT**: Enabling this parameter automatically disables: -
keepTextSizeForObfuscation
- Text size preservation is not maintained -consistentObfuscation
- Standard consistency rules are overridden - file-based fakersThis is necessary because geographic consistency requires specific fake address selection that may not preserve original text lengths or follow standard obfuscation patterns.
default: false
- Definition Classes
- BaseDeidParams
-
def
get[T](feature: StructFeature[T]): Option[T]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
get[K, V](feature: MapFeature[K, V]): Option[Map[K, V]]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
get[T](feature: SetFeature[T]): Option[Set[T]]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
get[T](feature: ArrayFeature[T]): Option[Array[T]]
- Attributes
- protected
- Definition Classes
- HasFeatures
-
final
def
get[T](param: Param[T]): Option[T]
- Definition Classes
- Params
-
def
getAdditionalDateFormats: Array[String]
Gets the value of additionalDateFormats
Gets the value of additionalDateFormats
- Definition Classes
- BaseDeidParams
-
def
getAgeRanges: Array[Int]
Gets ageRanges param.
Gets ageRanges param.
- Definition Classes
- BaseDeidParams
-
def
getAgeRangesByHipaa: Boolean
Gets the value of ageRangesByHipaa.
Gets the value of ageRangesByHipaa.
- Definition Classes
- BaseDeidParams
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
getConsistentAcrossNameParts: Boolean
Gets the value of consistentAcrossNameParts.
Gets the value of consistentAcrossNameParts.
- Definition Classes
- BaseDeidParams
-
def
getCountryObfuscation: Boolean
Gets the value of countryObfuscation.
Gets the value of countryObfuscation.
- Definition Classes
- BaseDeidParams
-
def
getCustomFakers: Map[String, List[String]]
Gets customFakers param.
Gets customFakers param.
- Attributes
- protected
- Definition Classes
- LightDeIdentificationParams
-
def
getDateEntities: Array[String]
Gets dateEntities param.
Gets dateEntities param.
- Definition Classes
- BaseDeidParams
-
def
getDateFormats: Array[String]
Gets the value of dateFormats
Gets the value of dateFormats
- Definition Classes
- BaseDeidParams
-
def
getDays: Int
Gets days param
Gets days param
- Definition Classes
- BaseDeidParams
-
final
def
getDefault[T](param: Param[T]): Option[T]
- Definition Classes
- Params
-
def
getEntitiesBySentence(chunks: Seq[Annotation], sentenceCount: Int): Seq[Seq[Annotation]]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getEntityBasedObfuscationRefSource(entityClass: String): String
- Attributes
- protected
- Definition Classes
- BaseDeidParams
-
def
getEntityField(annotation: Annotation): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getExternalFakers(entityClass: String, customFakers: Map[String, List[String]], wordToReplace: String): List[String]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getFakeByHashcode(fakes: Seq[String], wordToReplace: String, entity: String, seed: Int): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getFakeWithSameSize(fakes: Seq[String], wordToReplace: String, entity: String, lengthDeviation: Int, seed: Int): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getFakerLengthOffset: Int
Gets fakerLengthOffset param
Gets fakerLengthOffset param
- Definition Classes
- BaseDeidParams
-
def
getFakersEntity(entity: String, result: String): Seq[String]
- Definition Classes
- DeidModelParams
-
def
getFhirVersion: String
Gets the value of fhirVersion
-
def
getFixedMaskLength: Int
Gets fixedMaskLength param.
Gets fixedMaskLength param.
- Definition Classes
- MaskingParams
-
def
getGenderAwareness: Boolean
Gets genderAwareness param.
Gets genderAwareness param.
- Definition Classes
- BaseDeidParams
-
def
getGeoConsistency: Boolean
Gets the value of geoConsistency.
Gets the value of geoConsistency.
- Definition Classes
- BaseDeidParams
-
final
def
getInputCol: String
- Definition Classes
- HasInputCol
-
def
getKeepMonth: Boolean
Gets keepMonth param
Gets keepMonth param
- Definition Classes
- BaseDeidParams
-
def
getKeepTextSizeForObfuscation: Boolean
Gets keepTextSizeForObfuscation param
Gets keepTextSizeForObfuscation param
- Definition Classes
- BaseDeidParams
-
def
getKeepYear: Boolean
Gets keepYear param
Gets keepYear param
- Definition Classes
- BaseDeidParams
-
def
getLanguage: String
Gets language param.
Gets language param.
- Definition Classes
- BaseDeidParams
- def getMappingRules: Map[String, String]
- def getMappingRulesAsStr: String
-
def
getMaskStatus(entityClass: String): String
- Attributes
- protected
- Definition Classes
- MaskingParams
-
def
getMaskingPolicy: String
Gets maskingPolicy param.
Gets maskingPolicy param.
- Definition Classes
- MaskingParams
-
def
getMaxSentence(annotations: Seq[Annotation]): Int
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getMode: String
Gets mode param.
Gets mode param.
- Definition Classes
- BaseDeidParams
-
def
getObfuscateDate: Boolean
Gets obfuscateDate param
Gets obfuscateDate param
- Definition Classes
- BaseDeidParams
-
def
getObfuscateRefSource: String
Gets obfuscateRefSource param.
Gets obfuscateRefSource param.
- Definition Classes
- BaseDeidParams
-
final
def
getOrDefault[T](param: Param[T]): T
- Definition Classes
- Params
-
final
def
getOutputCol: String
- Definition Classes
- HasOutputAnnotationCol
-
def
getParam(paramName: String): Param[Any]
- Definition Classes
- Params
-
def
getParserType: String
Gets the value of parserType
-
def
getRegion: String
Gets region param.
Gets region param.
- Definition Classes
- BaseDeidParams
-
def
getSameLengthFormattedEntities(): Array[String]
- Definition Classes
- BaseDeidParams
-
def
getSeed(): Int
- Definition Classes
- BaseDeidParams
-
def
getSelectiveObfuscateRefSource: Map[String, String]
Gets selectiveObfuscateRefSource param.
Gets selectiveObfuscateRefSource param.
- Definition Classes
- BaseDeidParams
-
def
getSelectiveObfuscateRefSourceAsStr: String
- Definition Classes
- BaseDeidParams
-
def
getSelectiveObfuscationModes: Option[Map[String, Array[String]]]
Gets selectiveObfuscationModes param.
Gets selectiveObfuscationModes param.
- Definition Classes
- LightDeIdentificationParams
-
def
getShiftDaysFromSentences(sentences: Seq[Annotation]): Option[Int]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getStaticObfuscationFakes(entityClass: String, wordToReplace: String): Option[Seq[String]]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
getStaticObfuscationPairs: Option[Array[StaticObfuscationEntity]]
- Definition Classes
- BaseDeidParams
-
def
getUnnormalizedDateMode: String
Gets unnormalizedDateMode param.
Gets unnormalizedDateMode param.
- Definition Classes
- BaseDeidParams
-
def
getUseShiftDays: Boolean
Gets useShiftDays param.
Gets useShiftDays param.
- Definition Classes
- BaseDeidParams
-
def
getValidAgeRanges: Array[Int]
Gets valid ageRanges whether ageRangesByHipaa is true or not.
Gets valid ageRanges whether ageRangesByHipaa is true or not.
- Attributes
- protected
- Definition Classes
- BaseDeidParams
-
def
handleCasing(originalFake: String, wordToReplace: String): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
handleGeographicConsistency(protectedEntities: Seq[Seq[Annotation]]): Seq[Seq[Annotation]]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
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
-
final
val
inputCol: Param[String]
- Definition Classes
- HasInputCol
-
def
isArabic: Boolean
- Attributes
- protected
- Definition Classes
- MaskingParams
-
final
def
isDefined(param: Param[_]): Boolean
- Definition Classes
- Params
-
def
isEmptyString(value: String): Boolean
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
isGeoEntity(annotation: Annotation): Boolean
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
def
isGeoObfuscationEnabled: Boolean
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
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
keepMonth: BooleanParam
Whether to keep the month intact when obfuscating date entities.
Whether to keep the month intact when obfuscating date entities. If true, the month will remain unchanged during the obfuscation process. If false, the month will be modified along with the year and day. Default: false.
- Definition Classes
- BaseDeidParams
-
val
keepTextSizeForObfuscation: BooleanParam
It specifies whether the output should maintain the same character length as the input text.
It specifies whether the output should maintain the same character length as the input text. the output text will remain the same if same length is available, else length might vary.
- Definition Classes
- BaseDeidParams
-
val
keepYear: BooleanParam
Whether to keep the year intact when obfuscating date entities.
Whether to keep the year intact when obfuscating date entities. If true, the year will remain unchanged during the obfuscation process. If false, the year will be modified along with the month and day. Default: false.
- Definition Classes
- BaseDeidParams
-
val
language: Param[String]
The language used to select the regex file and some faker entities.
The language used to select the regex file and some faker entities. 'en'(English),'de'(German), 'es'(Spanish), 'fr'(French), 'ar'(Arabic) or 'ro'(Romanian) Default:'en'
- Definition Classes
- BaseDeidParams
-
implicit
lazy val
locale: Locale
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
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
-
val
mappingRules: MapFeature[String, String]
FHIR field de-identification rules for primitive type obfuscation.
FHIR field de-identification rules for primitive type obfuscation.
Overview
Defines how specific FHIR elements should be de-identified using FHIR Path syntax. Supports all FHIR primitive types with built-in obfuscation strategies.
-
def
maskEntity(wordToReplace: String, entityClass: String): String
- Attributes
- protected
- Definition Classes
- MaskingParams
-
def
maskEntity(annotation: Annotation, entityClass: String): String
- Attributes
- protected
- Definition Classes
- MaskingParams
-
def
maskEntityWithPolicy(wordToReplace: String, maskingPolicy: String, entityClass: String): String
- Attributes
- protected
- Definition Classes
- MaskingParams
-
def
maskEntityWithPolicy(annotation: Annotation, maskingPolicy: String, entityClass: String): String
- Attributes
- protected
- Definition Classes
- MaskingParams
-
val
maskingPolicy: Param[String]
Select the masking policy:
Select the masking policy:
- 'entity_labels': Replace the values with the entity value.
- 'same_length_chars': Replace the name with the asterix with same length minus two plus brackets on both end.If the entity is less than 3 chars (like Jo, or 5), we can just use asterix without brackets.
- 'fixed_length_chars': Replace the obfuscated entity with a masking sequence composed of a fixed number of asterisk.
- 'entity_labels_without_brackets': Replace the values with the entity value without brackets.
- 'same_length_chars_without_brackets': Replace the name with the asterix with same length without brackets.
- Default: 'entity_labels'
- Definition Classes
- MaskingParams
-
val
mode: Param[String]
Mode for Anonymizer ['mask' or 'obfuscate'].
Mode for Anonymizer ['mask' or 'obfuscate']. Default: 'mask'
- Mask mode: The entities will be replaced by their entity types.
- Obfuscate mode: The entity is replaced by an obfuscator's term.
- Definition Classes
- BaseDeidParams
Given the following text: "David Hale visited EEUU a couple of years ago"
- Mask mode: "
<
PERSON>
visited<
COUNTRY>
a couple of years ago" - Obfuscate mode: "Bryan Johnson visited Japan a couple of years ago"
- Mask mode: "
Example: -
val
nameEntities: Seq[String]
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
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
obfuscateDate: BooleanParam
When mode=="obfuscate" whether to obfuscate dates or not.
When mode=="obfuscate" whether to obfuscate dates or not. This param helps in consistency to make dateFormats more visible. When setting to
true
, make sure dateFormats param fits the needs. If the value is true and obfuscation is failed, then unnormalizedDateMode will be activated. When setting to 'false', then the date will be masked to <DATE>. Default: false- Definition Classes
- BaseDeidParams
-
def
obfuscateNameEntity(originalName: String, keepTextSize: Boolean, lengthDeviation: Int, namePartsMemory: Map[String, String]): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
obfuscateRefSource: Param[String]
The source of obfuscation to obfuscate the entities.
The source of obfuscation to obfuscate the entities. The values ar the following: 'file': Takes the entities from the obfuscatorRefFile 'faker': Takes the entities from the Faker module 'both': Takes the entities from the obfuscatorRefFile and the faker module randomly.
- Definition Classes
- BaseDeidParams
-
def
onWrite(path: String, spark: SparkSession): Unit
- Attributes
- protected
- Definition Classes
- ParamsAndFeaturesWritable
-
final
val
outputCol: Param[String]
- Attributes
- protected
- Definition Classes
- HasOutputAnnotationCol
-
lazy val
params: Array[Param[_]]
- Definition Classes
- Params
-
val
parserType: Param[String]
parser type to parse the FHIR string.
parser type to parse the FHIR string. Supported types are ").
-
lazy val
randomDateFormat: String
- Attributes
- protected
- Definition Classes
- BaseDeidParams
-
val
region: Param[String]
With this property, you can select particular dateFormats.
With this property, you can select particular dateFormats. This property is especially used when obfuscating dates. You can decide whether the first part of 11/11/2023 is a day or the second part is a day when obfuscating dates.
- The values are following:
- 'eu' for European Union
- 'us' for USA
- Definition Classes
- BaseDeidParams
-
val
sameLengthFormattedEntities: StringArrayParam
List of formatted entities to generate the same length outputs as original ones during obfuscation.
List of formatted entities to generate the same length outputs as original ones during obfuscation. The supported and default formatted entities are: "phone", "fax", "contact," "id", "idnum", "bioid", "medicalrecord", "zip", "vin", "ssn", "dln", "plate", "license", "IRS", "CFN", "account".
- Definition Classes
- BaseDeidParams
-
def
save(path: String): Unit
- Definition Classes
- MLWritable
- Annotations
- @Since( "1.6.0" ) @throws( ... )
-
val
seed: IntParam
It is the seed to select the entities on obfuscate mode.
It is the seed to select the entities on obfuscate mode. With the seed, you can reply to an execution several times with the same output.
- Definition Classes
- BaseDeidParams
-
def
selectFakeFromAllFakes(wordToReplace: String, entityClass: String, maskedEntity: String, allFakes: Seq[String]): String
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
selectiveObfuscateRefSource: MapFeature[String, String]
A map of entity names to their obfuscation modes.
A map of entity names to their obfuscation modes. This is used to selectively apply different obfuscation methods to specific entities. The keys are entity names and the values are the obfuscation sources. If an entity is not specified in this map, the obfuscateRefSource param is used to determine the obfuscation source.
- Definition Classes
- BaseDeidParams
val selectiveSources = Map( "PHONE" -> "file", "EMAIL" -> "faker", "NAME" -> "faker", "ADDRESS" -> "both" )
Example: -
val
selectiveObfuscationModes: StructFeature[Map[String, Array[String]]]
The dictionary of modes to enable multi-mode deidentification.
The dictionary of modes to enable multi-mode deidentification.
- 'obfuscate': Replace the values with random values.
- 'mask_same_length_chars': Replace the name with the asterix with same length minus two plus brackets on both end.
- 'mask_entity_labels': Replace the values with the entity value.
- 'mask_fixed_length_chars': Replace the name with the asterix with fixed length. You can also invoke "setFixedMaskLength()"
- 'mask_entity_labels_without_brackets': Replace the values with the entity value without brackets.
- 'mask_same_length_chars_without_brackets': Replace the name with the asterix with same length without brackets.
- 'skip': Skip the entities (intact)
The entities which have not been given in dictionary will deidentify according to setMode()
- Definition Classes
- LightDeIdentificationParams
-
def
set[T](feature: StructFeature[T], value: T): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
set[K, V](feature: MapFeature[K, V], value: Map[K, V]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
set[T](feature: SetFeature[T], value: Set[T]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
set[T](feature: ArrayFeature[T], value: Array[T]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
final
def
set(paramPair: ParamPair[_]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
set(param: String, value: Any): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
set[T](param: Param[T], value: T): FhirDeIdentification.this.type
- Definition Classes
- Params
-
def
setAdditionalDateFormats(formats: Array[String]): FhirDeIdentification.this.type
Sets additionalDateFormats param
Sets additionalDateFormats param
- Definition Classes
- BaseDeidParams
-
def
setAgeRanges(mode: Array[Int]): FhirDeIdentification.this.type
List of integers specifying limits of the age groups to preserve during obfuscation
List of integers specifying limits of the age groups to preserve during obfuscation
- Definition Classes
- BaseDeidParams
-
def
setAgeRangesByHipaa(value: Boolean): FhirDeIdentification.this.type
Sets whether to obfuscate ages based on HIPAA (Health Insurance Portability and Accountability Act) Privacy Rule.
Sets whether to obfuscate ages based on HIPAA (Health Insurance Portability and Accountability Act) Privacy Rule.
The HIPAA Privacy Rule mandates that ages from patients older than 90 years must be obfuscated, while age for patients 90 years or younger can remain unchanged.
- value
If true, age entities larger than 90 will be obfuscated as per HIPAA Privacy Rule, the others will remain unchanged. If false, ageRanges parameter is valid. Default: false.
- Definition Classes
- BaseDeidParams
-
def
setConsistentAcrossNameParts(value: Boolean): FhirDeIdentification.this.type
Sets the value of consistentAcrossNameParts.
Sets the value of consistentAcrossNameParts.
- value
Boolean flag to enforce consistency across name parts
- returns
this instance
- Definition Classes
- BaseDeidParams
-
def
setCountryObfuscation(value: Boolean): FhirDeIdentification.this.type
Sets whether to obfuscate country entities or not.
Sets whether to obfuscate country entities or not. If true, country entities will be obfuscated using the Faker module. If false, country entities will be skipped during obfuscation. Default: false
- Definition Classes
- BaseDeidParams
-
def
setCustomFakers(value: HashMap[String, List[String]]): FhirDeIdentification.this.type
- Definition Classes
- LightDeIdentificationParams
-
def
setCustomFakers(value: Map[String, Array[String]]): FhirDeIdentification.this.type
Sets the value of customFakers.
Sets the value of customFakers. The dictionary of custom fakers to specify the obfuscation terms for the entities. You can specify the entity and the terms to be used for obfuscation.
Example:
new LightDeIdentification() .setInputCols(Array("ner_chunk", "sentence")).setOutputCol("dei") .setMode("obfuscate") .setObfuscateRefSource("custom") .setCustomFakers(Map( "NAME" -> Array("George", "Taylor"), "SCHOOL" -> Array("Oxford", "Harvard"), "city" -> Array("ROMA") ))
- Definition Classes
- LightDeIdentificationParams
-
def
setDateEntities(value: Array[String]): FhirDeIdentification.this.type
Sets the value of dateEntities.
Sets the value of dateEntities. Default: Array("DATE", "DOB", "DOD", "EFFDATE", "FISCAL_YEAR")
- Definition Classes
- BaseDeidParams
-
def
setDateFormats(s: Array[String]): FhirDeIdentification.this.type
Format of dates to displace
Format of dates to displace
- Definition Classes
- BaseDeidParams
-
def
setDays(k: Int): FhirDeIdentification.this.type
Number of days to obfuscate the dates by displacement.
Number of days to obfuscate the dates by displacement. If not provided a random integer between 1 and 60 will be used
- Definition Classes
- BaseDeidParams
-
def
setDefault[T](feature: StructFeature[T], value: () ⇒ T): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
setDefault[K, V](feature: MapFeature[K, V], value: () ⇒ Map[K, V]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
setDefault[T](feature: SetFeature[T], value: () ⇒ Set[T]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
def
setDefault[T](feature: ArrayFeature[T], value: () ⇒ Array[T]): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- HasFeatures
-
final
def
setDefault(paramPairs: ParamPair[_]*): FhirDeIdentification.this.type
- Attributes
- protected
- Definition Classes
- Params
-
final
def
setDefault[T](param: Param[T], value: T): FhirDeIdentification.this.type
- Attributes
- protected[org.apache.spark.ml]
- Definition Classes
- Params
-
def
setFakerLengthOffset(value: Int): FhirDeIdentification.this.type
Sets fakerLengthOffset param
Sets fakerLengthOffset param
- Definition Classes
- BaseDeidParams
-
def
setFhirVersion(value: String): FhirDeIdentification.this.type
Sets the value of fhirVersion.
Sets the value of fhirVersion. The FHIR version to de-identify. Supported versions are "). Default is R4.
-
def
setFixedMaskLength(value: Int): FhirDeIdentification.this.type
Sets the value of fixedMaskLength.
Sets the value of fixedMaskLength. This is the length of the masking sequence that will be used when the 'fixed_length_chars' masking policy is selected.
- Definition Classes
- MaskingParams
-
def
setGenderAwareness(value: Boolean): FhirDeIdentification.this.type
Whether to use gender-aware names or not during obfuscation.
Whether to use gender-aware names or not during obfuscation. This param effects only names. If value is true, it might decrease performance. Default: False
- Definition Classes
- BaseDeidParams
-
def
setGeoConsistency(value: Boolean): FhirDeIdentification.this.type
Sets the value of geoConsistency.
Sets the value of geoConsistency. When set to
true
, it enables consistent obfuscation across geographical entities such as state, city, street, zip, and phone.- Definition Classes
- BaseDeidParams
-
def
setInputCol(value: String): FhirDeIdentification.this.type
Set the input column name.
Set the input column name. The input column should contain the FHIR string.
-
def
setKeepMonth(value: Boolean): FhirDeIdentification.this.type
Sets whether to keep the month intact when obfuscating date entities.
Sets whether to keep the month intact when obfuscating date entities. If true, the month will remain unchanged during the obfuscation process. If false, the month will be modified along with the year and day. Default: false.
- Definition Classes
- BaseDeidParams
-
def
setKeepTextSizeForObfuscation(value: Boolean): FhirDeIdentification.this.type
Sets keepTextSizeForObfuscation param
Sets keepTextSizeForObfuscation param
- Definition Classes
- BaseDeidParams
-
def
setKeepYear(value: Boolean): FhirDeIdentification.this.type
Sets whether to keep the year intact when obfuscating date entities.
Sets whether to keep the year intact when obfuscating date entities. If true, the year will remain unchanged during the obfuscation process. If false, the year will be modified along with the month and day. Default: false.
- Definition Classes
- BaseDeidParams
-
def
setLanguage(s: String): FhirDeIdentification.this.type
The language used to select the regex file and some faker entities.
The language used to select the regex file and some faker entities. 'en'(English),'de'(German), 'es'(Spanish), 'fr'(French), 'ar'(Arabic) or 'ro'(Romanian). Default:'en'
- Definition Classes
- BaseDeidParams
- def setMappingRules(value: HashMap[String, String]): FhirDeIdentification.this.type
-
def
setMappingRules(value: Map[String, String]): FhirDeIdentification.this.type
Sets FHIR field de-identification rules for primitive type obfuscation.
Sets FHIR field de-identification rules for primitive type obfuscation.
Overview
Defines how specific FHIR elements should be de-identified using FHIR Path syntax. Supports all FHIR primitive types with built-in obfuscation strategies.
Rule Format
Map( "ResourceType.field.path" -> "SupportedEntityClass", )
- value
A mapping between FHIR paths and target primitive types. Keys must use standard FHIR Path notation (dot-delimited). Values must be one of the supported de-identification entity classes or given as a custom list.
Basic Usage
new FhirDeIdentification() .setMappingRules(Map( "Patient.birthDate" -> "Date", "Patient.name.given" -> "Name", "Patient.telecom.value" -> "Email", "Patient.address.city" -> "City", ))
- Exceptions thrown
If:
- Unsupported primitive type provided
- Malformed FHIR path detected
- Non-primitive field targeted
- Note
Important Constraints: 1. Paths are case-sensitive and must match FHIR element names exactly 2. Array elements should use standard FHIR Path syntax (e.g.,
Patient.name.given
) 3. Only primitive types are supported for de-identification- See also
Example: -
def
setMaskingPolicy(value: String): FhirDeIdentification.this.type
Select the masking policy:
Select the masking policy:
- 'entity_labels': Replace the values with the entity value.
- 'same_length_chars': Replace the name with the asterix with same length minus two plus brackets on both end.If the entity is less than 3 chars (like Jo, or 5), we can just use asterix without brackets.
- 'fixed_length_chars': Replace the obfuscated entity with a masking sequence composed of a fixed number of asterisk.
- 'entity_labels_without_brackets': Replace the values with the entity value without brackets.
- 'same_length_chars_without_brackets': Replace the name with the asterix with same length without brackets.
- Default: 'entity_labels'
- Definition Classes
- MaskingParams
-
def
setMode(m: String): FhirDeIdentification.this.type
Mode for Anonymizer ['mask'|'obfuscate'].
Mode for Anonymizer ['mask'|'obfuscate']. Default: 'mask'
- Mask mode: The entities will be replaced by their entity types.
- Obfuscate mode: The entity is replaced by an obfuscator's term.
- Definition Classes
- BaseDeidParams
Given the following text: "David Hale visited EEUU a couple of years ago"
- Mask mode: "
<
PERSON>
visited<
COUNTRY>
a couple of years ago" - Obfuscate mode: "Bryan Johnson visited Japan a couple of years ago"
- Mask mode: "
Example: -
def
setObfuscateDate(s: Boolean): FhirDeIdentification.this.type
obfuscateDate param is not supported in FhirDeIdentification.
obfuscateDate param is not supported in FhirDeIdentification. It is always true.
- Definition Classes
- FhirDeIdentification → BaseDeidParams
- Exceptions thrown
-
def
setObfuscateRefSource(s: String): FhirDeIdentification.this.type
The source of obfuscation to obfuscate the entities.
The source of obfuscation to obfuscate the entities. The values are the following: 'file': Takes the fakes from the obfuscatorRefFile 'faker': Takes the fakes from the Faker module 'both': Takes the fakes from the obfuscatorRefFile and the faker module randomly.
- Definition Classes
- BaseDeidParams
-
final
def
setOutputCol(value: String): FhirDeIdentification.this.type
- Definition Classes
- HasOutputAnnotationCol
-
def
setParserType(value: String): FhirDeIdentification.this.type
Sets the value of parserType.
Sets the value of parserType. The parser type to parse the FHIR string. Supported types are ").
-
def
setRegion(value: String): FhirDeIdentification.this.type
region param is not supported in FhirDeIdentification.
region param is not supported in FhirDeIdentification. Please use dateFormats instead.
- Definition Classes
- FhirDeIdentification → BaseDeidParams
- Exceptions thrown
-
def
setSameLengthFormattedEntities(entities: Array[String]): FhirDeIdentification.this.type
List of formatted entities to generate the same length outputs as original ones during obfuscation.
List of formatted entities to generate the same length outputs as original ones during obfuscation. The supported and default formatted entities are: PHONE, FAX, CONTACT, ID, IDNUM, BIOID, MEDICALRECORD, ZIP, VIN, SSN, DLN, LICENSE, PLATE, IRS, CFN, ACCOUNT.
- Definition Classes
- BaseDeidParams
-
def
setSeed(s: Int): FhirDeIdentification.this.type
It is the seed to select the entities on obfuscate mode.
It is the seed to select the entities on obfuscate mode. With the seed, you can reply to an execution several times with the same output.
- Definition Classes
- BaseDeidParams
-
def
setSelectiveObfuscateRefSource(value: HashMap[String, String]): FhirDeIdentification.this.type
- Definition Classes
- BaseDeidParams
-
def
setSelectiveObfuscateRefSource(value: Map[String, String]): FhirDeIdentification.this.type
Sets the value of selectiveObfuscateRefSource.
Sets the value of selectiveObfuscateRefSource. This is used to selectively apply different obfuscation methods to specific entities. The keys are entity names and the values are the obfuscation sources. If an entity is not specified in this map, the obfuscateRefSource param is used to determine the obfuscation method. The values can be: - 'file': Takes the fakes from the file. - 'faker': Takes the fakes from the embedded faker module. - 'both': Takes the fakes from the file and the faker module.
- Definition Classes
- BaseDeidParams
val modes = Map( "PHONE" -> "file", "EMAIL" -> "faker", "NAME" -> "faker", "ADDRESS" -> "both" )
Example: -
def
setSelectiveObfuscationModes(value: HashMap[String, List[String]]): FhirDeIdentification.this.type
- Definition Classes
- LightDeIdentificationParams
-
def
setSelectiveObfuscationModes(value: Map[String, Array[String]]): FhirDeIdentification.this.type
Sets the value of selectiveObfuscationModes.
Sets the value of selectiveObfuscationModes. The dictionary of modes to enable multi-mode deidentification.
- 'obfuscate': Replace the values with random values.
- 'mask_same_length_chars': Replace the name with the asterix with same length minus two plus brackets on both end.
- 'mask_entity_labels': Replace the values with the entity value.
- 'mask_fixed_length_chars': Replace the name with the asterix with fixed length. You should also invoke "setFixedMaskLength()"
- 'mask_entity_labels_without_brackets': Replace the values with the entity value without brackets.
- 'mask_same_length_chars_without_brackets': Replace the name with the asterix with same length without brackets.
- 'skip': Skip the entities (intact)
The entities which have not been given in dictionary will deidentify according to setMode()
Example:
val deIdentification = new LightDeIdentification() .setInputCols(Array("ner_chunk", "sentence")).setOutputCol("dei") .setMode("mask") .setSelectiveObfuscationModes(Map( "OBFUSCATE" -> Array("PHONE", "email"), "mask_entity_labels" -> Array("NAME", "CITY"), "skip" -> Array("id", "idnum"), "mask_same_length_chars" -> Array("fax"), "mask_fixed_length_chars" -> Array("zip") )) .setFixedMaskLength(4)
- Definition Classes
- LightDeIdentificationParams
-
def
setStaticObfuscationPairs(pairs: ArrayList[ArrayList[String]]): FhirDeIdentification.this.type
- Definition Classes
- BaseDeidParams
-
def
setStaticObfuscationPairs(pairs: Array[StaticObfuscationEntity]): FhirDeIdentification.this.type
- Definition Classes
- BaseDeidParams
-
def
setStaticObfuscationPairs(pairs: Array[Array[String]]): FhirDeIdentification.this.type
Sets the static obfuscation pairs.
Sets the static obfuscation pairs. Each pair should contain three elements: original, entity type, and fake. The pairs must have exactly 3 elements: [original, entityType, fake].
- pairs
An array of arrays containing the static obfuscation pairs.
- Definition Classes
- BaseDeidParams
-
def
setUnnormalizedDateMode(mode: String): FhirDeIdentification.this.type
The mode to use if the date is not formatted.
The mode to use if the date is not formatted. Options: [mask, obfuscate, skip] Default: obfuscate
- Definition Classes
- BaseDeidParams
-
def
setUseShiftDays(s: Boolean): FhirDeIdentification.this.type
useShiftDays param is not supported in FhirDeIdentification.
useShiftDays param is not supported in FhirDeIdentification. Please use days instead.
- Definition Classes
- FhirDeIdentification → BaseDeidParams
- Exceptions thrown
-
def
shouldUseConsistentNameParts(entityClass: String): Boolean
- Attributes
- protected
- Definition Classes
- DeidModelParams
-
val
staticObfuscationPairs: StructFeature[Array[StaticObfuscationEntity]]
A resource containing static obfuscation pairs.
A resource containing static obfuscation pairs. Each pair should contain three elements: original, entity type, and fake.
- Definition Classes
- BaseDeidParams
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- Identifiable → AnyRef → Any
-
def
transform(dataset: Dataset[_]): DataFrame
- Definition Classes
- FhirDeIdentification → 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
- Definition Classes
- FhirDeIdentification → PipelineStage
-
def
transformSchema(schema: StructType, logging: Boolean): StructType
- Attributes
- protected
- Definition Classes
- PipelineStage
- Annotations
- @DeveloperApi()
-
val
uid: String
- Definition Classes
- FhirDeIdentification → Identifiable
-
val
unnormalizedDateMode: Param[String]
The mode to use if the date is not formatted.
The mode to use if the date is not formatted. Options: [mask, obfuscate, skip] Default: obfuscate
- Definition Classes
- BaseDeidParams
-
val
useShiftDays: BooleanParam
Whether to use the random shift day when the document has this in its metadata.
Whether to use the random shift day when the document has this in its metadata. DocumentHashCoder can create 'dateshift' based on the document. Default: false
- Definition Classes
- BaseDeidParams
-
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
- ParamsAndFeaturesWritable → DefaultParamsWritable → MLWritable