dkist-processing-visp 5.2.2__py3-none-any.whl → 5.2.4__py3-none-any.whl

dkist_processing_visp/tests/conftest.py

@@ -22,6 +22,8 @@ from dkist_processing_common.tasks import WorkflowTaskBase
 
 # Don't remove this; tests will break
 from dkist_processing_common.tests.mock_metadata_store import fake_gql_client
+from solar_wavelength_calibration import Atlas
+from solar_wavelength_calibration import DownloadConfig
 
 from dkist_processing_visp.models.constants import VispConstants
 from dkist_processing_visp.models.parameters import VispParameters
@@ -179,7 +181,7 @@ class VispInputDatasetParameterValues:
     visp_wavecal_pixel_pitch_micron_per_pix: float = 6.5
     visp_wavecal_atlas_download_config: dict[str, str] = field(
         default_factory=lambda: {
-            "base_url": "doi:10.5281/zenodo.14646787/",
+            "base_url": "https://g-a36282.cd214.a567.data.globus.org/atlas/",
             "telluric_reference_atlas_file_name": "telluric_reference_atlas.npy",
             "telluric_reference_atlas_hash_id": "md5:8db5e12508b293bca3495d81a0747447",
             "solar_reference_atlas_file_name": "solar_reference_atlas.npy",
@@ -568,3 +570,10 @@ def write_calibrated_frames_to_task(
         data_func=make_random_data,
     )
     return num_written_frames
+
+
+@pytest.fixture(scope="session")
+def solar_atlas() -> Atlas:
+    config = VispInputDatasetParameterValues().visp_wavecal_atlas_download_config
+    config = DownloadConfig.model_validate(config)
+    return Atlas(config=config)

dkist_processing_visp/tests/test_solar.py

@@ -16,7 +16,6 @@ from dkist_processing_common.codecs.fits import fits_array_decoder
 from dkist_processing_common.codecs.fits import fits_array_encoder
 from dkist_processing_common.models.tags import Tag
 from scipy.ndimage import gaussian_filter1d
-from solar_wavelength_calibration import Atlas
 from sunpy.coordinates import HeliocentricInertial
 
 from dkist_processing_visp.models.tags import VispTag
@@ -136,11 +135,6 @@ def resolving_power() -> int:
     return int(1.15e5)
 
 
-@pytest.fixture(scope="session")
-def solar_atlas() -> Atlas:
-    return Atlas()
-
-
 @pytest.fixture(scope="session")
 def spectral_vignette_function(num_wave_pix) -> np.ndarray:
     return (np.arange(num_wave_pix) - num_wave_pix // 2) / (num_wave_pix * 10) + 1.0

dkist_processing_visp/tests/test_wavelength_calibration.py

@@ -10,7 +10,6 @@ from dkist_processing_common.codecs.fits import fits_array_encoder
 from dkist_processing_common.codecs.json import json_decoder
 from dkist_processing_common.models.metric_code import MetricCode
 from scipy.ndimage import gaussian_filter
-from solar_wavelength_calibration import Atlas
 
 from dkist_processing_visp.models.tags import VispTag
 from dkist_processing_visp.tasks.wavelength_calibration import WavelengthCalibration
@@ -110,11 +109,6 @@ def resolving_power() -> int:
     return int(1.15e5)
 
 
-@pytest.fixture(scope="session")
-def solar_atlas() -> Atlas:
-    return Atlas()
-
-
 @pytest.fixture(scope="function")
 def visp_wavelength_correction_task(
     tmp_path,

{dkist_processing_visp-5.2.2.dist-info → dkist_processing_visp-5.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dkist-processing-visp
-Version: 5.2.2
+Version: 5.2.4
 Summary: Science processing code for the ViSP instrument on DKIST
 Author-email: NSO / AURA <dkistdc@nso.edu>
 License: BSD-3-Clause
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.12
 Description-Content-Type: text/x-rst
-Requires-Dist: dkist-processing-common==11.9.1
+Requires-Dist: dkist-processing-common==11.9.3
 Requires-Dist: dkist-processing-math==2.2.1
 Requires-Dist: dkist-processing-pac==3.1.1
 Requires-Dist: dkist-header-validator==5.2.1
@@ -93,22 +93,22 @@ Requires-Dist: WTForms==3.2.1; extra == "frozen"
 Requires-Dist: Werkzeug==2.2.3; extra == "frozen"
 Requires-Dist: aioftp==0.27.2; extra == "frozen"
 Requires-Dist: aiohappyeyeballs==2.6.1; extra == "frozen"
-Requires-Dist: aiohttp==3.13.2; extra == "frozen"
+Requires-Dist: aiohttp==3.13.3; extra == "frozen"
 Requires-Dist: aiosignal==1.4.0; extra == "frozen"
 Requires-Dist: aiosmtplib==5.0.0; extra == "frozen"
 Requires-Dist: alembic==1.17.2; extra == "frozen"
 Requires-Dist: amqp==5.3.1; extra == "frozen"
 Requires-Dist: annotated-types==0.7.0; extra == "frozen"
-Requires-Dist: anyio==4.12.0; extra == "frozen"
+Requires-Dist: anyio==4.12.1; extra == "frozen"
 Requires-Dist: apache-airflow==2.11.0; extra == "frozen"
-Requires-Dist: apache-airflow-providers-celery==3.14.1; extra == "frozen"
-Requires-Dist: apache-airflow-providers-common-compat==1.10.1; extra == "frozen"
+Requires-Dist: apache-airflow-providers-celery==3.15.0; extra == "frozen"
+Requires-Dist: apache-airflow-providers-common-compat==1.11.0; extra == "frozen"
 Requires-Dist: apache-airflow-providers-common-io==1.7.0; extra == "frozen"
-Requires-Dist: apache-airflow-providers-common-sql==1.30.1; extra == "frozen"
+Requires-Dist: apache-airflow-providers-common-sql==1.30.2; extra == "frozen"
 Requires-Dist: apache-airflow-providers-fab==1.5.3; extra == "frozen"
 Requires-Dist: apache-airflow-providers-ftp==3.14.0; extra == "frozen"
-Requires-Dist: apache-airflow-providers-http==5.6.1; extra == "frozen"
-Requires-Dist: apache-airflow-providers-imap==3.10.1; extra == "frozen"
+Requires-Dist: apache-airflow-providers-http==5.6.2; extra == "frozen"
+Requires-Dist: apache-airflow-providers-imap==3.10.2; extra == "frozen"
 Requires-Dist: apache-airflow-providers-postgres==6.5.1; extra == "frozen"
 Requires-Dist: apache-airflow-providers-smtp==2.4.1; extra == "frozen"
 Requires-Dist: apache-airflow-providers-sqlite==4.2.0; extra == "frozen"
@@ -118,19 +118,19 @@ Requires-Dist: asdf==3.5.0; extra == "frozen"
 Requires-Dist: asdf_standard==1.4.0; extra == "frozen"
 Requires-Dist: asdf_transform_schemas==0.6.0; extra == "frozen"
 Requires-Dist: asgiref==3.11.0; extra == "frozen"
-Requires-Dist: asteval==1.0.7; extra == "frozen"
+Requires-Dist: asteval==1.0.8; extra == "frozen"
 Requires-Dist: astropy==7.0.2; extra == "frozen"
-Requires-Dist: astropy-iers-data==0.2025.12.15.0.40.51; extra == "frozen"
+Requires-Dist: astropy-iers-data==0.2026.1.5.0.43.43; extra == "frozen"
 Requires-Dist: asyncpg==0.31.0; extra == "frozen"
 Requires-Dist: attrs==25.4.0; extra == "frozen"
 Requires-Dist: babel==2.17.0; extra == "frozen"
 Requires-Dist: billiard==4.2.4; extra == "frozen"
 Requires-Dist: blinker==1.9.0; extra == "frozen"
-Requires-Dist: boto3==1.42.11; extra == "frozen"
-Requires-Dist: botocore==1.42.11; extra == "frozen"
+Requires-Dist: boto3==1.42.24; extra == "frozen"
+Requires-Dist: botocore==1.42.24; extra == "frozen"
 Requires-Dist: cachelib==0.13.0; extra == "frozen"
-Requires-Dist: celery==5.6.0; extra == "frozen"
-Requires-Dist: certifi==2025.11.12; extra == "frozen"
+Requires-Dist: celery==5.6.2; extra == "frozen"
+Requires-Dist: certifi==2026.1.4; extra == "frozen"
 Requires-Dist: cffi==2.0.0; extra == "frozen"
 Requires-Dist: charset-normalizer==3.4.4; extra == "frozen"
 Requires-Dist: click==8.3.1; extra == "frozen"
@@ -150,23 +150,22 @@ Requires-Dist: dacite==1.9.2; extra == "frozen"
 Requires-Dist: decorator==5.2.1; extra == "frozen"
 Requires-Dist: dill==0.4.0; extra == "frozen"
 Requires-Dist: dkist-header-validator==5.2.1; extra == "frozen"
-Requires-Dist: dkist-processing-common==11.9.1; extra == "frozen"
+Requires-Dist: dkist-processing-common==11.9.3; extra == "frozen"
 Requires-Dist: dkist-processing-core==6.0.1; extra == "frozen"
 Requires-Dist: dkist-processing-math==2.2.1; extra == "frozen"
 Requires-Dist: dkist-processing-pac==3.1.1; extra == "frozen"
-Requires-Dist: dkist-processing-visp==5.2.2; extra == "frozen"
+Requires-Dist: dkist-processing-visp==5.2.4; extra == "frozen"
 Requires-Dist: dkist-service-configuration==4.1.13; extra == "frozen"
 Requires-Dist: dkist-spectral-lines==3.0.0; extra == "frozen"
 Requires-Dist: dkist_fits_specifications==4.19.0; extra == "frozen"
 Requires-Dist: dnspython==2.8.0; extra == "frozen"
 Requires-Dist: email-validator==2.3.0; extra == "frozen"
-Requires-Dist: exceptiongroup==1.3.1; extra == "frozen"
 Requires-Dist: fastjsonschema==2.21.2; extra == "frozen"
 Requires-Dist: flower==2.0.1; extra == "frozen"
 Requires-Dist: fonttools==4.61.1; extra == "frozen"
 Requires-Dist: frozenlist==1.8.0; extra == "frozen"
 Requires-Dist: fsspec==2025.12.0; extra == "frozen"
-Requires-Dist: globus-sdk==4.2.0; extra == "frozen"
+Requires-Dist: globus-sdk==4.3.0; extra == "frozen"
 Requires-Dist: google-re2==1.1.20251105; extra == "frozen"
 Requires-Dist: googleapis-common-protos==1.72.0; extra == "frozen"
 Requires-Dist: gqlclient==1.2.3; extra == "frozen"
@@ -176,19 +175,19 @@ Requires-Dist: gunicorn==23.0.0; extra == "frozen"
 Requires-Dist: h11==0.16.0; extra == "frozen"
 Requires-Dist: httpcore==1.0.9; extra == "frozen"
 Requires-Dist: httpx==0.28.1; extra == "frozen"
-Requires-Dist: humanize==4.14.0; extra == "frozen"
+Requires-Dist: humanize==4.15.0; extra == "frozen"
 Requires-Dist: idna==3.11; extra == "frozen"
 Requires-Dist: imageio-ffmpeg==0.6.0; extra == "frozen"
-Requires-Dist: importlib_metadata==8.7.0; extra == "frozen"
+Requires-Dist: importlib_metadata==8.7.1; extra == "frozen"
 Requires-Dist: inflection==0.5.1; extra == "frozen"
 Requires-Dist: itsdangerous==2.2.0; extra == "frozen"
 Requires-Dist: jmespath==1.0.1; extra == "frozen"
 Requires-Dist: joblib==1.5.3; extra == "frozen"
-Requires-Dist: jsonschema==4.25.1; extra == "frozen"
+Requires-Dist: jsonschema==4.26.0; extra == "frozen"
 Requires-Dist: jsonschema-specifications==2025.9.1; extra == "frozen"
 Requires-Dist: jupyter_core==5.9.1; extra == "frozen"
 Requires-Dist: kiwisolver==1.4.9; extra == "frozen"
-Requires-Dist: kombu==5.6.1; extra == "frozen"
+Requires-Dist: kombu==5.6.2; extra == "frozen"
 Requires-Dist: lazy-object-proxy==1.12.0; extra == "frozen"
 Requires-Dist: lazy_loader==0.4; extra == "frozen"
 Requires-Dist: limits==5.6.0; extra == "frozen"
@@ -197,7 +196,7 @@ Requires-Dist: lmfit==1.3.4; extra == "frozen"
 Requires-Dist: lockfile==0.12.2; extra == "frozen"
 Requires-Dist: loguru==0.7.3; extra == "frozen"
 Requires-Dist: markdown-it-py==4.0.0; extra == "frozen"
-Requires-Dist: marshmallow==3.26.1; extra == "frozen"
+Requires-Dist: marshmallow==3.26.2; extra == "frozen"
 Requires-Dist: marshmallow-oneofschema==3.2.0; extra == "frozen"
 Requires-Dist: marshmallow-sqlalchemy==0.28.2; extra == "frozen"
 Requires-Dist: matplotlib==3.10.8; extra == "frozen"
@@ -240,7 +239,7 @@ Requires-Dist: packaging==25.0; extra == "frozen"
 Requires-Dist: pandas==2.3.3; extra == "frozen"
 Requires-Dist: parfive==2.2.0; extra == "frozen"
 Requires-Dist: pathlib_abc==0.5.2; extra == "frozen"
-Requires-Dist: pathspec==0.12.1; extra == "frozen"
+Requires-Dist: pathspec==1.0.1; extra == "frozen"
 Requires-Dist: pendulum==3.1.0; extra == "frozen"
 Requires-Dist: pika==1.3.2; extra == "frozen"
 Requires-Dist: pillow==10.4.0; extra == "frozen"
@@ -254,14 +253,14 @@ Requires-Dist: prometheus_client==0.23.1; extra == "frozen"
 Requires-Dist: prompt_toolkit==3.0.52; extra == "frozen"
 Requires-Dist: propcache==0.4.1; extra == "frozen"
 Requires-Dist: protobuf==6.33.2; extra == "frozen"
-Requires-Dist: psutil==7.1.3; extra == "frozen"
+Requires-Dist: psutil==7.2.1; extra == "frozen"
 Requires-Dist: psycopg2-binary==2.9.11; extra == "frozen"
 Requires-Dist: pycparser==2.23; extra == "frozen"
 Requires-Dist: pydantic==2.12.5; extra == "frozen"
 Requires-Dist: pydantic-settings==2.12.0; extra == "frozen"
 Requires-Dist: pydantic_core==2.41.5; extra == "frozen"
 Requires-Dist: pyerfa==2.0.1.5; extra == "frozen"
-Requires-Dist: pyparsing==3.2.5; extra == "frozen"
+Requires-Dist: pyparsing==3.3.1; extra == "frozen"
 Requires-Dist: python-daemon==3.1.2; extra == "frozen"
 Requires-Dist: python-dateutil==2.9.0.post0; extra == "frozen"
 Requires-Dist: python-dotenv==1.2.1; extra == "frozen"
@@ -285,15 +284,15 @@ Requires-Dist: setproctitle==1.3.7; extra == "frozen"
 Requires-Dist: six==1.17.0; extra == "frozen"
 Requires-Dist: solar-wavelength-calibration==2.0.0; extra == "frozen"
 Requires-Dist: sqids==0.5.1; extra == "frozen"
-Requires-Dist: sqlparse==0.5.4; extra == "frozen"
+Requires-Dist: sqlparse==0.5.5; extra == "frozen"
 Requires-Dist: sunpy==6.1.1; extra == "frozen"
 Requires-Dist: tabulate==0.9.0; extra == "frozen"
 Requires-Dist: talus==1.3.4; extra == "frozen"
 Requires-Dist: tenacity==8.5.0; extra == "frozen"
-Requires-Dist: termcolor==3.2.0; extra == "frozen"
+Requires-Dist: termcolor==3.3.0; extra == "frozen"
 Requires-Dist: text-unidecode==1.3; extra == "frozen"
 Requires-Dist: threadpoolctl==3.6.0; extra == "frozen"
-Requires-Dist: tifffile==2025.12.12; extra == "frozen"
+Requires-Dist: tifffile==2025.12.20; extra == "frozen"
 Requires-Dist: tornado==6.5.4; extra == "frozen"
 Requires-Dist: tqdm==4.67.1; extra == "frozen"
 Requires-Dist: traitlets==5.14.3; extra == "frozen"
@@ -304,9 +303,9 @@ Requires-Dist: tzlocal==5.3.1; extra == "frozen"
 Requires-Dist: uc-micro-py==1.0.3; extra == "frozen"
 Requires-Dist: uncertainties==3.2.3; extra == "frozen"
 Requires-Dist: universal_pathlib==0.3.7; extra == "frozen"
-Requires-Dist: urllib3==2.6.2; extra == "frozen"
+Requires-Dist: urllib3==2.6.3; extra == "frozen"
 Requires-Dist: vine==5.1.0; extra == "frozen"
-Requires-Dist: voluptuous==0.15.2; extra == "frozen"
+Requires-Dist: voluptuous==0.16.0; extra == "frozen"
 Requires-Dist: wcwidth==0.2.14; extra == "frozen"
 Requires-Dist: wirerope==1.0.0; extra == "frozen"
 Requires-Dist: wrapt==1.17.3; extra == "frozen"

{dkist_processing_visp-5.2.2.dist-info → dkist_processing_visp-5.2.4.dist-info}/RECORD

@@ -40,7 +40,7 @@ dkist_processing_visp/tasks/mixin/corrections.py,sha256=FhLFgD9ZYLZd3SaC3PFF-szr
 dkist_processing_visp/tasks/mixin/downsample.py,sha256=SvKzY6HJRn-FeyG7O6HPvyOS5dmMu6uPoWkfnpPXpVw,1344
 dkist_processing_visp/tests/README.rst,sha256=rnedwwg25c0lB9Me7cT7QNZA17FYlqCu9ZnjQxR5hi0,12502
 dkist_processing_visp/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dkist_processing_visp/tests/conftest.py,sha256=poJPxGK8RZlDYEoGkwaIyX08WDgf2aF566uJJbZsldk,19049
+dkist_processing_visp/tests/conftest.py,sha256=JJLg-x4Rfzrk3wp-vBN0EpnnBzQzXS4qdGmr7GXBNwM,19402
 dkist_processing_visp/tests/header_models.py,sha256=gD1FUo5TtY_EMSnpWvkrJIOsckkgRAD-e1mthPCdiOw,21687
 dkist_processing_visp/tests/test_assemble_movie.py,sha256=T5EZzdB3sNY4HcSkN2W1ZBDaI4a68ZUNqPB-JpANSQ0,2247
 dkist_processing_visp/tests/test_assemble_quality.py,sha256=i2INzb73BM14A6VKD70eb5vaAv5_QjPy3VVVb4lonkc,4314
@@ -57,10 +57,10 @@ dkist_processing_visp/tests/test_parameters.py,sha256=kIwOak4PURFc6yNT9R1rLxfb4x
 dkist_processing_visp/tests/test_parse.py,sha256=XyH8oCk5C0CWl4ndNIyVjgXLoMg0679s4dj1MGlJs0c,23363
 dkist_processing_visp/tests/test_quality.py,sha256=YW24VjEHoILseFIXZBp4-o7egT26mfT1lafzajVjXu8,6905
 dkist_processing_visp/tests/test_science.py,sha256=B8bbtVTxJIXiPssIbJchPLbzVTPCAzpLAgn5DhpYCn0,26106
-dkist_processing_visp/tests/test_solar.py,sha256=xtw8cbunonOG_6dRJHF9GIiQ5Q-KTBCdo1FZWkiA7_c,16761
+dkist_processing_visp/tests/test_solar.py,sha256=f5tk8RGOoC7fcxqp3s01p6I55iIDJBioKSXC1S56KMQ,16632
 dkist_processing_visp/tests/test_trial_create_quality_report.py,sha256=5LSvLiInp_ce_jObtBGNHQgVAkvJr9bYgY7IzIKrEuU,2799
 dkist_processing_visp/tests/test_visp_constants.py,sha256=y2x42Y-dK2lrCPufLAV1KHpu2fQ-FRpe8tSIhfHJEw8,3134
-dkist_processing_visp/tests/test_wavelength_calibration.py,sha256=usOCDd4yjmigpCjc5enQn14JJKojm8laxVJVDtV5PuU,9550
+dkist_processing_visp/tests/test_wavelength_calibration.py,sha256=bDWehEUb1xRo0EufRb3Fc8n_ko6_S3OdzasVA5Bs3rQ,9421
 dkist_processing_visp/tests/test_workflows.py,sha256=qyWxagIDv-MmVN0u3KFswa5HdaHC6uGeJpvgxvPE30E,287
 dkist_processing_visp/tests/test_write_l1.py,sha256=ZrAWhfx_HZi7dOBRc5YowvkKtMS8TBE_iud_KPjFI8g,6572
 dkist_processing_visp/tests/local_trial_workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -84,14 +84,14 @@ docs/l0_to_l1_visp.rst,sha256=wE1TT7DD93r3kByaFAaT2HO907pjV4YrJ_fzvJFTchw,623
 docs/l0_to_l1_visp_full-trial.rst,sha256=Y6YLkRA5b0tgui5l_WdthCx2wrXjLD8U97XKZHXVVBk,558
 docs/landing_page.rst,sha256=tdxWtmGjO7OUPYvRjgBAI461nubEE61HrtBwPdBeawI,1052
 docs/make.bat,sha256=mBAhtURwhQ7yc95pqwJzlhqBSvRknr1aqZ5s8NKvdKs,4513
-docs/polarization_calibration.rst,sha256=fYdB_FYB7NjvknuQIa3EGc4ZWjeUaBkkeRb8Y1bGihk,5068
+docs/polarization_calibration.rst,sha256=iPs-ichH7_m-_7_sisZNwv2X5H5CjIOaEe4-FiU4C18,6233
 docs/requirements.txt,sha256=Kbl_X4c7RQZw035YTeNB63We6I7pvXFU4T0Uflp2yDY,29
 docs/requirements_table.rst,sha256=_HIbwFpDooM5n0JjiDAbFozGfJuX13smtcoujLFN4Gk,292
 docs/science_calibration.rst,sha256=VN_g7xSjN-nbXhlBaFnPCbNcsc_Qu0207jEUfRAjnBE,2939
 docs/scientific_changelog.rst,sha256=01AWBSHg8zElnodCgAq-hMxhk9CkX5rtEENx4iz0sjI,300
 docs/wavelength_calibration.rst,sha256=OSGYAeR8Acns2ZUectHzRj2xcAsuNEMLejcYfPYu-vw,3674
 licenses/LICENSE.rst,sha256=piZaQplkzOMmH1NXg6QIdo9wwo9pPCoHkvm2-DmH76E,1462
-dkist_processing_visp-5.2.2.dist-info/METADATA,sha256=UCKkJRm8UpkRs67vUkPZ9B6cMPlIiWBJZZ_K0_ejB48,30023
-dkist_processing_visp-5.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-dkist_processing_visp-5.2.2.dist-info/top_level.txt,sha256=9GHSn-ZMGQxaRNGrPP3HNc5ZkE7ftzluO74Jz5vUSTE,46
-dkist_processing_visp-5.2.2.dist-info/RECORD,,
+dkist_processing_visp-5.2.4.dist-info/METADATA,sha256=ECnvVPk_MfVjkj1wywJO_jZeG7LucYyiaoArRuO0bm4,29962
+dkist_processing_visp-5.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dkist_processing_visp-5.2.4.dist-info/top_level.txt,sha256=9GHSn-ZMGQxaRNGrPP3HNc5ZkE7ftzluO74Jz5vUSTE,46
+dkist_processing_visp-5.2.4.dist-info/RECORD,,

docs/polarization_calibration.rst

@@ -40,8 +40,9 @@ Algorithm Detail
 
 The general algorithm is:
 
-#. Correct input PolCal data with dark, :doc:`background <background_light>`, :doc:`gain </gain_correction>`, and
-   :doc:`geometric </geometric>` calibrations.
+#. Generate polcal dark and gain frames.
+
+#. Correct input PolCal data with darks and gains taken as part of the instrument polarization sequence, as well as any :doc:`background light <background_light>` correction, if applicable.
 
 #. Bin "global" and "local" sets of polcal data.
 
@@ -51,11 +52,29 @@ The general algorithm is:
 
 #. Up-sample the binned demodulation matrices to span the full ViSP FOV.
 
-Calibrate Input PoCal Data
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+Generate PolCal Dark and Gain Frames
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+PolCal data are reduced using darks and gains taken as part of the PolCal sequence.
+
+This approach ensures that PolCal data are always reducible, even in cases where the exposure times of observe darks and PolCal darks differ due to experimental setup errors.
+For consistency with other spectro-polarimetric instruments, it is important that the observe darks and PolCal darks have matching
+exposure times (or at least matching frame and single frame exposure times). Using PolCal darks guarantees that the PolCal data can
+always be properly reduced, regardless of such discrepancies.
+
+
+For gain correction, the average of the dark-corrected
+'clear' PolCal frames is used. This change ensures that spectral line signatures are largely removed from the data, preventing bias
+in the median value calculated across the spectral axis. The same average clear frame is applied to all PolCal data through division,
+and to all modulation states identically, preserving relative flux changes between states. With this approach, a separate gain
+array is not necessary.
+
+
+Calibrate Input PolCal Data
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-PoCal data are calibration in exactly the same way as input science data. They first have dark and background signals
-removed, then are normalized by a gain image before finally having their :doc:`geometric </geometric>` distortions
+PoCal data first have PolCal dark and background signals
+removed, then are normalized by the average PolCal gain image before finally having their :doc:`geometric </geometric>` distortions
 (spectral rotation, x/y offset, and spectral curvature) removed.
 
 Bin PolCal Data