
com.johnsnowlabs.nlp.annotators.cv.JanusforMultiModal.scala Maven / Gradle / Ivy
/*
* Copyright 2017-2024 John Snow Labs
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.johnsnowlabs.nlp.annotators.cv
import com.johnsnowlabs.ml.ai.util.Generation.GenerationConfig
import com.johnsnowlabs.ml.ai.Janus
import com.johnsnowlabs.ml.onnx.OnnxWrapper.DecoderWrappers
import com.johnsnowlabs.ml.util.LoadExternalModel.{
loadJsonStringAsset,
loadTextAsset,
modelSanityCheck,
notSupportedEngineError
}
import com.johnsnowlabs.nlp.annotators.cv.feature_extractor.Preprocessor
import com.johnsnowlabs.ml.util.Openvino
import com.johnsnowlabs.nlp.AnnotatorType.{DOCUMENT, IMAGE}
import com.johnsnowlabs.nlp._
import org.json4s.{DefaultFormats, JValue}
import org.json4s.jackson.JsonMethods.parse
import com.johnsnowlabs.ml.openvino.{OpenvinoWrapper, ReadOpenvinoModel, WriteOpenvinoModel}
import com.johnsnowlabs.ml.openvino.OpenvinoWrapper.JanusWrappers
import com.johnsnowlabs.nlp.serialization.{MapFeature, StructFeature}
import org.apache.spark.broadcast.Broadcast
import org.apache.spark.ml.param.{IntArrayParam, IntParam, BooleanParam}
import org.apache.spark.ml.util.Identifiable
import org.apache.spark.sql.SparkSession
/** JanusForMultiModal can load Janus models for unified multimodal understanding and generation.
* The model consists of a vision encoder, a text encoder, and a text decoder. Janus decouples
* visual encoding for enhanced flexibility, leveraging a unified transformer architecture for
* both understanding and generation tasks.
*
* Janus uses SigLIP-L as the vision encoder, supporting 384 x 384 image inputs. For image
* generation, it utilizes a tokenizer with a downsample rate of 16. The framework is based on
* DeepSeek-LLM-1.3b-base, trained on approximately 500B text tokens.
*
* Pretrained models can be loaded with `pretrained` from the companion object: {{ val visualQA =
* JanusForMultiModal.pretrained() .setInputCols("image_assembler") .setOutputCol("answer") }}
* The default model is "janus_1_3b_int4" if no name is provided.
*
* For available pretrained models, please refer to the
* [[https://sparknlp.org/models?task=Question+Answering Models Hub]].
*
* Models from the HuggingFace 🤗 Transformers library are also compatible with Spark NLP 🚀. For
* compatibility details and import instructions, see
* [[https://github.com/JohnSnowLabs/spark-nlp/discussions/5669]]. For extended examples, refer
* to
* [[https://github.com/JohnSnowLabs/spark-nlp/blob/master/src/test/scala/com/johnsnowlabs/nlp/annotators/cv/JanusForMultiModalTest.scala]].
*
* ==Example==
* {{ import spark.implicits._
*
* import com.johnsnowlabs.nlp.base._
*
* import com.johnsnowlabs.nlp.annotator._
*
* import org.apache.spark.ml.Pipeline
*
* val imageDF: DataFrame = ResourceHelper.spark.read .format("image") .option("dropInvalid",
* value = true) .load(imageFolder)
*
* val testDF: DataFrame = imageDF.withColumn("text", lit("User: Describe
* image in details Assistant:"))
*
* val imageAssembler: ImageAssembler = new ImageAssembler() .setInputCol("image")
* .setOutputCol("image_assembler")
*
* val visualQAClassifier = JanusForMultiModal.pretrained() .setInputCols("image_assembler")
* .setOutputCol("answer")
*
* val pipeline = new Pipeline().setStages(Array( imageAssembler, visualQAClassifier ))
*
* val result = pipeline.fit(testDF).transform(testDF)
*
* result.select("image_assembler.origin", "answer.result").show(false)
* | origin | result |
* |:---------------------------------------|:----------------------------------------------------------------------------------------|
* | [file:///content/images/cat_image.jpg] | [The unusual aspect of this picture is the presence of two cats lying on a pink couch.] |
* }}
*
* @see
* [[CLIPForZeroShotClassification]] for Zero Shot Image Classification
* @see
* [[https://sparknlp.org/docs/en/annotators Annotators Main Page]] for a list of
* transformer-based classifiers
* @param uid
* Required UID for storing the annotator to disk
* @groupname anno Annotator types
* @groupdesc anno
* Required input and expected output annotator types
* @groupname Ungrouped Members
* @groupname param Parameters
* @groupname setParam Parameter setters
* @groupname getParam Parameter getters
* @groupprio param 1
* @groupprio anno 2
* @groupprio Ungrouped 3
* @groupprio setParam 4
* @groupprio getParam 5
* @groupdesc param
* A list of (hyper-)parameter keys this annotator can take. Users can set and get the
* parameter values through setters and getters, respectively.
*/
class JanusForMultiModal(override val uid: String)
extends AnnotatorModel[JanusForMultiModal]
with HasBatchedAnnotateImage[JanusForMultiModal]
with HasImageFeatureProperties
with WriteOpenvinoModel
with HasGeneratorProperties
with HasEngine {
/** Annotator reference id. Used to identify elements in metadata or to refer to this annotator
* type
*/
def this() = this(Identifiable.randomUID("JanusForMultiModal"))
/** Annotator reference id. Used to identify elements in metadata or to refer to this annotator
* type
*/
override val inputAnnotatorTypes: Array[AnnotatorType] = Array(IMAGE)
override val outputAnnotatorType: AnnotatorType = DOCUMENT
/** A list of token ids which are ignored in the decoder's output (Default: `Array()`)
*
* @group param
*/
var ignoreTokenIds = new IntArrayParam(
this,
"ignoreTokenIds",
"A list of token ids which are ignored in the decoder's output")
/** @group setParam */
def setIgnoreTokenIds(tokenIds: Array[Int]): JanusForMultiModal.this.type = {
set(ignoreTokenIds, tokenIds)
}
/** @group getParam */
def getIgnoreTokenIds: Array[Int] = $(ignoreTokenIds)
/** Vocabulary used to encode the words to ids with bpeTokenizer.encode
*
* @group param
*/
val vocabulary: MapFeature[String, Int] = new MapFeature(this, "vocabulary").setProtected()
/** @group setParam */
def setVocabulary(value: Map[String, Int]): this.type = set(vocabulary, value)
/** Holding merges.txt coming from RoBERTa model
*
* @group param
*/
val merges: MapFeature[(String, String), Int] = new MapFeature(this, "merges").setProtected()
/** @group setParam */
def setMerges(value: Map[(String, String), Int]): this.type = set(merges, value)
/** Additional tokens to be added to the vocabulary
*
* @group param
*/
val addedTokens: MapFeature[String, Int] = new MapFeature(this, "addedTokens").setProtected()
/** @group setParam */
def setAddedTokens(value: Map[String, Int]): this.type = set(addedTokens, value)
/** Stop tokens to terminate the generation
*
* @group param
*/
override val stopTokenIds =
new IntArrayParam(this, "stopTokenIds", "Stop tokens to terminate the generation")
/** @group setParam */
override def setStopTokenIds(value: Array[Int]): this.type = {
set(stopTokenIds, value)
}
/** @group getParam */
override def getStopTokenIds: Array[Int] = $(stopTokenIds)
private var _model: Option[Broadcast[Janus]] = None
val generationConfig: StructFeature[GenerationConfig] =
new StructFeature(this, "generationConfig").setProtected()
def setGenerationConfig(value: GenerationConfig): this.type =
set(generationConfig, value)
def getGenerationConfig: GenerationConfig = $$(generationConfig)
val imageToken =
new IntParam(this, "imageToken", "Token id for image embeddings")
/** @group setParam */
def setImageToken(value: Int): this.type = set(imageToken, value)
/** @group getParam */
def getImageToken: Int = $(imageToken)
val imageTokenLength =
new IntParam(this, "imageTokenLength", "Token length for image embeddings")
/** @group setParam */
def setImageTokenLength(value: Int): this.type = set(imageTokenLength, value)
/** @group getParam */
def getImageTokenLength: Int = $(imageTokenLength)
val imageGenerateMode: BooleanParam =
new BooleanParam(this, "imageGenerateMode", "Image generation mode")
/** @group setParam */
def setImageGenerateMode(value: Boolean): this.type = set(imageGenerateMode, value)
/** @group getParam */
def getImageGenerateMode: Boolean = $(imageGenerateMode)
val numOfParallelImages: IntParam =
new IntParam(this, "numOfParallelImages", "Number of parallel images to Generate")
/** @group setParam */
def setNumOfParallelImages(value: Int): this.type = set(numOfParallelImages, value)
/** @group getParam */
def getNumOfParallelImages: Int = $(numOfParallelImages)
/** @group setParam */
def setModelIfNotSet(
spark: SparkSession,
preprocessor: Preprocessor,
onnxWrappers: Option[DecoderWrappers],
openvinoWrapper: Option[JanusWrappers]): this.type = {
if (_model.isEmpty) {
_model = Some(
spark.sparkContext.broadcast(
new Janus(
onnxWrappers,
openvinoWrapper,
$$(merges),
$$(vocabulary),
$$(addedTokens),
preprocessor,
generationConfig = getGenerationConfig,
imageToken = getImageToken,
imageTokenLength = getImageTokenLength)))
}
this
}
/** @group getParam */
def getModelIfNotSet: Janus = _model.get.value
setDefault(
minOutputLength -> 0,
maxOutputLength -> 20,
doSample -> false,
temperature -> 0.6,
topK -> -1,
topP -> 0.9,
repetitionPenalty -> 1.0,
noRepeatNgramSize -> 3,
ignoreTokenIds -> Array(),
batchSize -> 1,
beamSize -> 1,
maxInputLength -> 4096,
stopTokenIds -> Array(2),
imageToken -> 100594,
imageTokenLength -> 576,
imageGenerateMode -> false,
numOfParallelImages -> 1)
/** takes a document and annotations and produces new annotations of this annotator's annotation
* type
*
* @param batchedAnnotations
* Annotations in batches that correspond to inputAnnotationCols generated by previous
* annotators if any
* @return
* any number of annotations processed for every batch of input annotations. Not necessary
* one to one relationship
*/
override def batchAnnotate(
batchedAnnotations: Seq[Array[AnnotationImage]]): Seq[Seq[Annotation]] = {
batchedAnnotations
// .filter { annotationImages =>
// annotationImages.exists(_.text.nonEmpty)
// }
.map { cleanAnnotationImages =>
val validImages = cleanAnnotationImages.filter(_.result.nonEmpty)
val questionAnnotations = extractInputAnnotation(validImages)
getModelIfNotSet.predict(
questionAnnotations,
validImages.toSeq,
imageGenerateMode = $(imageGenerateMode),
batchSize = $(batchSize),
minOutputLength = $(minOutputLength),
maxOutputLength = $(maxOutputLength),
doSample = $(doSample),
temperature = $(temperature),
topK = $(topK),
topP = $(topP),
repetitionPenalty = $(repetitionPenalty),
noRepeatNgramSize = $(noRepeatNgramSize),
randomSeed = this.randomSeed,
ignoreTokenIds = $(ignoreTokenIds),
beamSize = $(beamSize),
maxInputLength = $(maxInputLength),
numOfParallelImages = $(numOfParallelImages))
}
}
private def extractInputAnnotation(
annotationImages: Array[AnnotationImage]): Seq[Annotation] = {
val questions = annotationImages.map(annotationImage => {
val imageText =
if (annotationImage.text.nonEmpty) annotationImage.text
else
"You are a helpful language and vision assistant. You are able to understand the visual content that the user provides, and assist the user with a variety of tasks using natural language.\\n\\nUser: Describe image in details\\n\\nAssistant:" // default question
Annotation(imageText)
})
questions
}
override def onWrite(path: String, spark: SparkSession): Unit = {
super.onWrite(path, spark)
getEngine match {
case Openvino.name =>
val wrappers = getModelIfNotSet.openvinoWrapper
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.languageModel, "openvino_language_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.visionEmbeddingsModel, "openvino_vision_embeddings_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.textEmbeddingsModel, "openvino_text_embeddings_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.mergeModel, "openvino_multimodal_merge_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.lmHeadModel, "openvino_lm_head_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.genHeadModel, "openvino_gen_head_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.genEmbeddingsModel, "openvino_gen_embeddings_model.xml")),
JanusForMultiModal.suffix)
writeOpenvinoModels(
path,
spark,
Seq((wrappers.get.genDecoderModel, "openvino_gen_decoder_model.xml")),
JanusForMultiModal.suffix)
case _ =>
throw new Exception(notSupportedEngineError)
}
}
}
trait ReadablePretrainedJanusForMultiModal
extends ParamsAndFeaturesReadable[JanusForMultiModal]
with HasPretrained[JanusForMultiModal] {
override val defaultModelName: Some[String] = Some("janus_1_3b_int4")
/** Java compliant-overrides */
override def pretrained(): JanusForMultiModal = super.pretrained()
override def pretrained(name: String): JanusForMultiModal =
super.pretrained(name)
override def pretrained(name: String, lang: String): JanusForMultiModal =
super.pretrained(name, lang)
override def pretrained(name: String, lang: String, remoteLoc: String): JanusForMultiModal =
super.pretrained(name, lang, remoteLoc)
}
trait ReadJanusForMultiModalDLModel extends ReadOpenvinoModel {
this: ParamsAndFeaturesReadable[JanusForMultiModal] =>
val suffix: String = "_Janus"
override val openvinoFile: String = "Janus_openvino"
def readModel(instance: JanusForMultiModal, path: String, spark: SparkSession): Unit = {
instance.getEngine match {
case Openvino.name =>
val languageModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_language_model.xml"), suffix)
val visionEmbeddingsModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_vision_embeddings_model.xml"), suffix)
val textEmbeddingsModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_text_embeddings_model.xml"), suffix)
val mergeModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_multimodal_merge_model.xml"), suffix)
val lmHeadModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_lm_head_model.xml"), suffix)
val genHeadModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_gen_head_model.xml"), suffix)
val genEmbeddingsModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_gen_embeddings_model.xml"), suffix)
val genDecoderModelWrappers =
readOpenvinoModels(path, spark, Seq("openvino_gen_decoder_model.xml"), suffix)
val ovWrapper = JanusWrappers(
languageModel = languageModelWrappers("openvino_language_model.xml"),
visionEmbeddingsModel =
visionEmbeddingsModelWrappers("openvino_vision_embeddings_model.xml"),
textEmbeddingsModel = textEmbeddingsModelWrappers("openvino_text_embeddings_model.xml"),
mergeModel = mergeModelWrappers("openvino_multimodal_merge_model.xml"),
lmHeadModel = lmHeadModelWrappers("openvino_lm_head_model.xml"),
genHeadModel = genHeadModelWrappers("openvino_gen_head_model.xml"),
genEmbeddingsModel = genEmbeddingsModelWrappers("openvino_gen_embeddings_model.xml"),
genDecoderModel = genDecoderModelWrappers("openvino_gen_decoder_model.xml"))
val preprocessor = Preprocessor(
do_normalize = true,
do_resize = true,
"JanusFeatureExtractor",
instance.getImageMean,
instance.getImageStd,
instance.getResample,
instance.getSize)
instance.setModelIfNotSet(spark, preprocessor, None, Some(ovWrapper))
case _ => {
throw new Exception(notSupportedEngineError)
}
}
}
addReader(readModel)
def loadSavedModel(
modelPath: String,
spark: SparkSession,
useOpenvino: Boolean = false): JanusForMultiModal = {
implicit val formats: DefaultFormats.type = DefaultFormats // for json4
val (localModelPath, detectedEngine) =
modelSanityCheck(
modelPath,
isDecoder = false,
custom = Some(
List(
"openvino_language_model",
"openvino_vision_embeddings_model",
"openvino_text_embeddings_model",
"openvino_multimodal_merge_model",
"openvino_lm_head_model",
"openvino_gen_head_model",
"openvino_gen_embeddings_model",
"openvino_gen_decoder_model")))
val modelConfig: JValue =
parse(loadJsonStringAsset(localModelPath, "config.json"))
val preprocessorConfigJsonContent =
loadJsonStringAsset(localModelPath, "preprocessor_config.json")
val preprocessorConfig = Preprocessor.loadPreprocessorConfig(preprocessorConfigJsonContent)
val beginSuppressTokens: Array[Int] =
(modelConfig \ "begin_suppress_tokens").extract[Array[Int]]
val suppressTokenIds: Array[Int] =
(modelConfig \ "suppress_tokens").extract[Array[Int]]
val forcedDecoderIds: Array[(Int, Int)] =
(modelConfig \ "forced_decoder_ids").extract[Array[Array[Int]]].map {
case idxWithTokenId: Array[Int] if idxWithTokenId.length == 2 =>
(idxWithTokenId(0), idxWithTokenId(1))
case _ =>
throw new Exception(
"Could not extract forced_decoder_ids. Should be a list of tuples with 2 entries.")
}
def arrayOrNone[T](array: Array[T]): Option[Array[T]] =
if (array.nonEmpty) Some(array) else None
val vocabSize = (modelConfig \ "language_config" \ "vocab_size").extract[Int]
val imageTokenLength = 576
// Check if tokenizer.json exists
val tokenizerPath = s"$localModelPath/assets/tokenizer.json"
val tokenizerExists = new java.io.File(tokenizerPath).exists()
val (vocabs, addedTokens, bytePairs) = if (tokenizerExists) {
val tokenizerConfig: JValue = parse(loadJsonStringAsset(localModelPath, "tokenizer.json"))
// extract vocab from tokenizer.json ( model -> vocab)
var vocabs: Map[String, Int] =
(tokenizerConfig \ "model" \ "vocab").extract[Map[String, Int]]
// extract merges from tokenizer.json ( model -> merges)
val bytePairs = (tokenizerConfig \ "model" \ "merges")
.extract[List[Array[String]]]
.filter(w => w.length == 2)
.map { case Array(c1, c2) => (c1, c2) }
.zipWithIndex
.toMap
// extract added_tokens from tokenizer.json (added_tokens)
// "added_tokens": [
// {
// "id": 128000,
// "content": "<|begin_of_text|>",
// "single_word": false,
// "lstrip": false,
// "rstrip": false,
// "normalized": false,
// "special": true
// }, ...
// ]
val addedTokens = (tokenizerConfig \ "added_tokens")
.extract[List[Map[String, Any]]]
.map { token =>
val id = token("id").asInstanceOf[BigInt].intValue()
val content = token("content").asInstanceOf[String]
(content, id)
}
.toMap
// update vocab with added tokens
addedTokens.foreach { case (content, id) =>
vocabs += (content -> id)
}
(vocabs, addedTokens, bytePairs)
} else {
val vocabs = loadTextAsset(localModelPath, "vocab.txt").zipWithIndex.toMap
val addedTokens = loadTextAsset(localModelPath, "added_tokens.txt").zipWithIndex.toMap
val bytePairs = loadTextAsset(localModelPath, "merges.txt")
.map(_.split(" "))
.filter(w => w.length == 2)
.map { case Array(c1, c2) => (c1, c2) }
.zipWithIndex
.toMap
(vocabs, addedTokens, bytePairs)
}
val tokenizerConfigFile: JValue =
parse(loadJsonStringAsset(localModelPath, "tokenizer_config.json"))
val bosToken = (tokenizerConfigFile \ "bos_token").extract[String]
val eosToken = (tokenizerConfigFile \ "eos_token").extract[String]
val padToken = (tokenizerConfigFile \ "pad_token").extract[String]
val bosTokenId = vocabs.getOrElse(bosToken, 100000)
val eosTokenId = vocabs.getOrElse(eosToken, 100001)
val padTokenId = vocabs.getOrElse(padToken, 100015)
val imageToken = vocabs.getOrElse("", 100594)
val annotatorModel = new JanusForMultiModal()
.setGenerationConfig(
GenerationConfig(
bosTokenId,
padTokenId,
eosTokenId,
vocabSize,
arrayOrNone(beginSuppressTokens),
arrayOrNone(suppressTokenIds),
arrayOrNone(forcedDecoderIds)))
.setVocabulary(vocabs)
.setMerges(bytePairs)
.setAddedTokens(addedTokens)
.setImageToken(imageToken)
.setImageTokenLength(imageTokenLength)
.setSize(preprocessorConfig.size)
.setImageMean(preprocessorConfig.image_mean)
.setImageStd(preprocessorConfig.image_std)
.setResample(preprocessorConfig.resample)
val modelEngine =
if (useOpenvino)
Openvino.name
else
detectedEngine
annotatorModel.set(annotatorModel.engine, modelEngine)
detectedEngine match {
case Openvino.name =>
val visionWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_vision_embeddings_model")
val textWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_text_embeddings_model")
val mergeWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_multimodal_merge_model")
val languageModelWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_language_model")
val lmHeadWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_lm_head_model")
val genHeadWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_gen_head_model")
val genEmbeddingsWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_gen_embeddings_model")
val genDecoderWrapper =
OpenvinoWrapper.read(
spark,
localModelPath,
zipped = false,
useBundle = true,
detectedEngine = detectedEngine,
modelName = "openvino_gen_decoder_model")
val openvinoWrapper = JanusWrappers(
languageModel = languageModelWrapper,
visionEmbeddingsModel = visionWrapper,
textEmbeddingsModel = textWrapper,
mergeModel = mergeWrapper,
lmHeadModel = lmHeadWrapper,
genHeadModel = genHeadWrapper,
genEmbeddingsModel = genEmbeddingsWrapper,
genDecoderModel = genDecoderWrapper)
annotatorModel.setModelIfNotSet(spark, preprocessorConfig, None, Some(openvinoWrapper))
case _ =>
throw new Exception(notSupportedEngineError)
}
annotatorModel
}
}
object JanusForMultiModal
extends ReadablePretrainedJanusForMultiModal
with ReadJanusForMultiModalDLModel
© 2015 - 2025 Weber Informatics LLC | Privacy Policy