Undate: computing with uncertain and partially-unknown dates

import%20marimo%0A%0A__generated_with%20%3D%20%220.16.5%22%0Aapp%20%3D%20marimo.App(%0A%20%20%20%20width%3D%22medium%22%2C%0A%20%20%20%20app_title%3D%22Undate%3A%20computing%20with%20uncertain%20and%20partially-unknown%20dates%22%2C%0A%20%20%20%20layout_file%3D%22data%3Aapplication%2Fjson%3Bbase64%2CewogICJ0eXBlIjogInNsaWRlcyIsCiAgImRhdGEiOiB7fQp9%22%2C%0A)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%20%20%20%20import%20pandas%20as%20pd%20%20%23%20for%20min%2Fmax%20date%20range%0A%20%20%20%20import%20altair%20as%20alt%0A%20%20%20%20import%20re%0A%0A%20%20%20%20%23%20path%20to%20public%20directory%20relative%20to%20this%20notebook%0A%20%20%20%20NOTEBOOK_PUBLIC_DIR%20%3D%20mo.notebook_location()%20%2F%20%22public%22%0A%20%20%20%20return%20NOTEBOOK_PUBLIC_DIR%2C%20alt%2C%20mo%2C%20pd%2C%20re%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Aasync%20def%20_()%3A%0A%20%20%20%20import%20sys%0A%0A%20%20%20%20%23%20when%20running%20under%20WASM%2C%20use%20micropip%20to%20install%20necessary%20dependencies%0A%20%20%20%20if%20sys.platform%20%3D%3D%20%22emscripten%22%3A%0A%20%20%20%20%20%20%20%20import%20micropip%0A%0A%20%20%20%20%20%20%20%20await%20micropip.install(%22polars%22)%0A%20%20%20%20%20%20%20%20%23%20PyMeeus%20is%20a%20dependency%20of%20convertdate%3B%20for%20some%20reason%20micropip%20can't%20install%20it%20automatically%0A%20%20%20%20%20%20%20%20await%20micropip.install(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22https%3A%2F%2Fwww.piwheels.org%2Fsimple%2Fpymeeus%2FPyMeeus-0.5.12-py3-none-any.whl%23sha256%3D3fb4b35e1efa77bcde9c858f5749f2eb0b315a53caba7825d25b89cf24c1b47f%22%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20await%20micropip.install(%22undate%3E%3D0.5.2%22)%0A%0A%20%20%20%20import%20polars%20as%20pl%0A%0A%20%20%20%20from%20undate%20import%20__version__%20as%20undate_version%0A%20%20%20%20return%20pl%2C%20undate_version%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20undate_version)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%23%20Undate%3A%20computing%20with%20uncertain%20and%20partially-unknown%20dates%0A%0A%20%20%20%20%60Undate%60%20is%20an%20**ambitious%2C%20in-progress%20effort**%20to%20develop%20a%20**pragmatic%20Python%20library**%20for%20computation%20and%20analysis%20of%20temporal%20information%20in%20humanistic%20and%20cultural%20data%2C%20with%20a%20particular%20emphasis%20on%20**uncertain%2C%20incomplete%2C%20or%20imprecise%20dates**%20and%20with%20support%20for%20**multiple%20calendars**.%0A%0A%20%20%20%20Researchers%20in%20the%20humanities%20often%20work%20with%20historical%20or%20cultural%20data%2C%20and%20knowing%20when%20particular%20materials%20were%20created%20or%20events%20happened%20is%20important%20for%20understanding%20the%20context%2C%20interpreting%20correctly%2C%20and%20determining%20relationships%20and%20sequencing.%20However%2C%20these%20kind%20of%20materials%20rarely%20have%20full%20precision%20dates%20with%20known%20year%2C%20month%2C%20and%20day.%20In%20some%20contexts%2C%20scholars%20may%20be%20happy%20if%20they%20can%20determine%20even%20just%20a%20century%20based%20on%20handwriting%20or%20mentions%20of%20historic%20coins.%0A%0A%20%20%20%20Humanistic%20and%20cultural%20data%20also%20often%20includes%20dates%20in%20different%20calendars%2C%20or%20even%20a%20mix%20of%20calendars%20within%20the%20same%20project%20or%20system.%20It's%20important%20to%20preserve%20the%20original%20date%20and%20calendar%20information%2C%20but%20it's%20also%20valuable%20to%20convert%20dates%20to%20a%20standard%20calendar%20so%20they%20can%20be%20compared%20and%20sorted%20together.%20%60Undate%60%20objects%20are%20calendar%20aware%20and%20calendar%20explicit%2C%20with%20a%20default%20of%20the%20Gregorian%20calendar.%20Currently%2C%20we%20support%20parsing%20and%20calendar%20conversion%20for%20dates%20in%20the%20Hebrew%20_Anno%20Mundi_%20calendar%20and%20Islamic%20_Hijri_%20calendar.%0A%0A%20%20%20%20This%20notebook%20demonstrates%20current%20use%20and%20functionality%20of%20the%20core%20%60Undate%60%20and%20%60UndateInterval%60%20objects%2C%20along%20with%20some%20examples%20and%20use-cases%20from%20specific%20projects.%0A%0A%0A%20%20%20%20----%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%22%22**Rebecca%20Sutton%20Koeser**%3Cbr%2F%3E%0A%20%20%20%20Lead%20Research%20Software%20Engineer%2C%20Center%20for%20Digital%20Humanities%20%40%20Princeton%3C%2Fbr%3E%0A%20%20%20%20*US-RSE'25%20notebook%20presentation*%20%7C%20available%20online%3A%20%5Bhttps%3A%2F%2Frlskoeser.github.io%2Fundate-notebook-usrse25%2F%5D(https%3A%2F%2Frlskoeser.github.io%2Fundate-notebook-usrse25%2F)%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%22%22%60undate%60%20v%7Bundate_version%7D%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20justify%3D%22space-between%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Basic%20functionality%0A%0A%20%20%20%20Like%20Python's%20builtin%20%60datetime.date%60%20object%2C%20an%20%60Undate%60%20can%20be%20initialized%20by%20specifying%20numeric%20values%20for%20**year**%2C%20**month**%2C%20and%20**day**.%0A%0A%20%20%20%20We%20can%20display%20them%20in%20a%20standard%20format%20(default%20serialization%20is%20**ISO8601**%2C%20or%20YYYY-MM-DD)%2C%20and%20we%20can%20compare%20them.%20An%20%60Undate%60%20object%20also%20has%20information%20about%20date%20precision%20and%20duration.%0A%0A%20%20%20%20_Unlike_%20Python's%20%60datetime.date%60%2C%20an%20%60Undate%60%20can%20be%20initialized%20without%20providing%20all%20values%20for%20year%2C%20month%2C%20and%20day.%0A%0A%20%20%20%20This%20means%20we%20can%20create%20%60Undate%60%20instances%20for%20the%20month%20of%20November%20in%202000%2C%20for%20the%20year%202000%2C%20or%20for%20November%207th%20in%20some%20unknown%20year%20or%20the%20month%20of%20February%20in%20an%20unknown%20year.%0A%0A%20%20%20%20%60Undate%60%20also%20has%20an%20optional%20%60label%60%20field%2C%20since%20it's%20sometimes%20useful%20to%20attach%20a%20label%20to%20date.%0A%0A%20%20%20%20%23%23%23%20Partially%20unknown%20values%0A%0A%20%20%20%20We%20can%20also%20intialize%20an%20%60Undate%60%20object%20with%20string%20values%2C%20when%20a%20date%20is%20only%20partially%20known.%20We%20use%20the%20character%20**X**%20to%20indicate%20an%20unknown%20digit%2C%20following%20the%20notation%20used%20in%20the%20%5BExtended%20Date%20Time%20Format%20(EDTF)%5D(https%3A%2F%2Fwww.loc.gov%2Fstandards%2Fdatetime%2F).%0A%20%20%20%20%22%22%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20import%20datetime%0A%0A%20%20%20%20from%20undate%20import%20Undate%0A%0A%20%20%20%20%23%20initialization%20options%0A%20%20%20%20option_values%20%3D%20%5B%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%202000%2C%20%22month%22%3A%2011%2C%20%22day%22%3A%207%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%202000%2C%20%22month%22%3A%2011%2C%20%22label%22%3A%20%22November%202000%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%202000%2C%20%22label%22%3A%20%22Y2K%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%202001%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22month%22%3A%2011%2C%20%22day%22%3A%207%2C%20%22label%22%3A%20%22Some%20November%207%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22month%22%3A%202%2C%20%22label%22%3A%20%22Some%20February%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%201916%2C%20%22month%22%3A%204%2C%20%22day%22%3A%2023%2C%20%22label%22%3A%20%22Easter%201916%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%20%2219XX%22%2C%20%22label%22%3A%20%221900s%22%7D%2C%0A%20%20%20%20%20%20%20%20%7B%22year%22%3A%202022%2C%20%22month%22%3A%20%221X%22%2C%20%22label%22%3A%20%22late%202022%22%7D%2C%0A%20%20%20%20%5D%0A%0A%0A%20%20%20%20def%20display_opts(input_opts)%3A%0A%20%20%20%20%20%20%20%20%23%20format%20dictionary%20input%20options%20for%20display%0A%20%20%20%20%20%20%20%20opts%20%3D%20%5B%5D%0A%20%20%20%20%20%20%20%20for%20key%2C%20val%20in%20input_opts.items()%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20wrap%20strings%20in%20quotes%20to%20differentiate%20from%20numbers%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20isinstance(val%2C%20str)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20val%20%3D%20f'%22%7Bval%7D%22'%0A%20%20%20%20%20%20%20%20%20%20%20%20opts.append(f%22%7Bkey%7D%3D%7Bval%7D%22)%0A%20%20%20%20%20%20%20%20return%20%22%2C%20%22.join(opts)%0A%0A%0A%20%20%20%20%23%20generate%20a%20radio%20button%20input%20to%20try%20out%20the%20different%20input%20options%0A%20%20%20%20options%20%3D%20%7Bdisplay_opts(val)%3A%20val%20for%20val%20in%20option_values%7D%0A%20%20%20%20first_option%20%3D%20list(options.keys())%5B%0A%20%20%20%20%20%20%20%200%0A%20%20%20%20%5D%20%20%23%20pre-select%20first%20option%20so%20following%20functionality%20always%20has%20a%20value%0A%0A%20%20%20%20init_options%20%3D%20mo.ui.radio(%0A%20%20%20%20%20%20%20%20options%3Doptions%2C%0A%20%20%20%20%20%20%20%20label%3D%22Initialization%20options%22%2C%0A%20%20%20%20%20%20%20%20value%3Dfirst_option%2C%0A%20%20%20%20)%0A%20%20%20%20return%20Undate%2C%20datetime%2C%20display_opts%2C%20init_options%2C%20option_values%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20datetime%2C%20display_opts%2C%20init_options%2C%20mo)%3A%0A%20%20%20%20display_init_opts%20%3D%20display_opts(init_options.value)%0A%0A%20%20%20%20undate_obj%20%3D%20Undate(**init_options.value)%0A%0A%20%20%20%20dt_error_msg%20%3D%20%22%22%0A%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20dt_obj%20%3D%20datetime.date(**init_options.value)%0A%20%20%20%20except%20TypeError%20as%20dt_err%3A%0A%20%20%20%20%20%20%20%20dt_obj%20%3D%20None%0A%20%20%20%20%20%20%20%20dt_error_msg%20%3D%20f%22**%7Bdt_err.__class__.__name__%7D**%3A%20%7Bdt_err%7D%22%0A%0A%20%20%20%20undate_output%20%3D%20mo.md(f%22%22%22%0A%20%20%20%20%20%20%20%20%7Bundate_obj%7D%0A%0A%20%20%20%20%20%20%20%20%60%7Brepr(undate_obj)%7D%60%0A%20%20%20%20%22%22%22).callout(%22success%22)%0A%0A%20%20%20%20init_successful_callout%20%3D%20mo.callout(%0A%20%20%20%20%20%20%20%20%22Initalization%20succeeded.%22%2C%20kind%3D%22success%22%0A%20%20%20%20)%0A%20%20%20%20dt_err_callout%20%3D%20mo.callout(mo.md(dt_error_msg)%2C%20kind%3D%22warn%22)%0A%0A%20%20%20%20undate_display%20%3D%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%23%23%20%60undate.Undate%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%60undate.Undate(%7Bdisplay_init_opts%7D)%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(str(undate_obj))%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%60%7Brepr(undate_obj)%7D%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22Date%20precision%3A%20%7Bundate_obj.precision%7D%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22Duration%20in%20days%3A%20%60%7Bundate_obj.duration().days%7D%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20init_successful_callout%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20align%3D%22center%22%2C%0A%20%20%20%20)%0A%20%20%20%20dt_display%20%3D%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%23%23%20%60datetime.date%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%60datetime.date(%7Bdisplay_init_opts%7D)%60%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(str(dt_obj))%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%60%7Brepr(dt_obj)%7D%60%22%20if%20dt_obj%20else%20%22-%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22Date%20precision%3A%20day%22%20if%20dt_obj%20else%20%22-%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22Duration%20in%20days%3A%201%22%20if%20dt_obj%20else%20%22-%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20dt_err_callout%20if%20dt_error_msg%20else%20init_successful_callout%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20align%3D%22center%22%2C%0A%20%20%20%20)%0A%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%5Binit_options%5D%2C%20justify%3D%22center%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22-----------------------------%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5Bundate_display%2C%20dt_display%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20justify%3D%22space-between%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20widths%3D%22equal%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20align%3D%22stretch%22%2C%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20option_values%2C%20pl)%3A%0A%20%20%20%20%23%20initialize%20data%20with%20some%20sample%20dates%3B%20display%20on%20next%20slide%20with%20text%0A%20%20%20%20sample_dates%20%3D%20%5BUndate(**opts)%20for%20opts%20in%20option_values%5D%0A%20%20%20%20%23%20sample_dates.append(datetime.date(**option_values%5B0%5D))%0A%20%20%20%20sample_date_df%20%3D%20pl.DataFrame(%0A%20%20%20%20%20%20%20%20data%3D%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22undate%22%3A%20sample_dates%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22year%22%3A%20%5Bd.year%20for%20d%20in%20sample_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22month%22%3A%20%5Bd.month%20for%20d%20in%20sample_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22day%22%3A%20%5Bd.day%20for%20d%20in%20sample_dates%5D%2C%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20)%0A%20%20%20%20return%20sample_date_df%2C%20sample_dates%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20sample_date_df)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%22%22%23%23%23%20Date%20Comparisons%0A%0A%0A%20%20%20%20We%20can%20also%20do%20some%20simple%20calculations%2C%20like%20checking%20whether%20one%20date%20falls%20within%20another%20date.%0A%0A%20%20%20%20When%20an%20%60Undate%60%20instance%20is%20initialized%2C%20internally%20the%20class%20calculates%20earliest%20and%20latest%20possible%20values%20for%20that%20date%20in%20the%20Gregorian%20calendar.%0A%0A%20%20%20%20This%20means%20that%20some%20comparisons%20are%20possible%20even%20without%20precise%20information.%0A%0A%20%20%20%20For%20instance%2C%20is%20a%20year%20sometime%20during%20the%201900s%20before%20a%20month%20in%20late%202022%3F%0A%0A%20%20%20%20Uncertain%20dates%20with%20the%20same%20initial%20values%20aren't%20equal%2C%20since%20they%20are%20uncertain.%0A%0A%20%20%20%20The%20%60Undate%60%20class%20has%20properties%20to%20return%20%60year%60%2C%20%60month%60%2C%20and%20%60day%60%20if%20they%20are%20known.%20They%20are%20returned%20as%20strings%20to%20allow%20for%20partially%20unknown%20dates%2C%20and%20return%20%60None%60%20when%20a%20value%20is%20unknown.%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20sample_date_df%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20comparison_opts%20%3D%20%7B%0A%20%20%20%20%20%20%20%20%22equals%20%3A%20%3D%3D%22%3A%20%22eq%22%2C%0A%20%20%20%20%20%20%20%20%22in%22%3A%20%22in%22%2C%0A%20%20%20%20%20%20%20%20%22greater%20than%20%3A%20%3E%22%3A%20%22gt%22%2C%0A%20%20%20%20%20%20%20%20%22less%20than%20%3A%20%3C%22%3A%20%22lt%22%2C%0A%20%20%20%20%7D%0A%0A%20%20%20%20cmp_opt%20%3D%20mo.ui.radio(%0A%20%20%20%20%20%20%20%20options%3Dcomparison_opts%2C%0A%20%20%20%20%20%20%20%20label%3D%22Comparison%20operator%22%2C%0A%20%20%20%20%20%20%20%20value%3D%22equals%20%3A%20%3D%3D%22%2C%0A%20%20%20%20)%0A%20%20%20%20return%20(cmp_opt%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(alt%2C%20cmp_opt%2C%20mo%2C%20pl%2C%20sample_dates)%3A%0A%20%20%20%20from%20itertools%20import%20combinations%0A%0A%0A%20%20%20%20def%20compare(d1%2C%20d2)%3A%0A%20%20%20%20%20%20%20%20result%20%3D%20None%0A%20%20%20%20%20%20%20%20result_text%20%3D%20None%20%20%23%20display%20version%20of%20result%0A%20%20%20%20%20%20%20%20op_str%20%3D%20%22%22%20%20%23%20display%20version%20of%20comparison%20operator%0A%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20cmp_opt.value%20%3D%3D%20%22eq%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20op_str%20%3D%20%22%3D%3D%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result%20%3D%20d1%20%3D%3D%20d2%0A%20%20%20%20%20%20%20%20%20%20%20%20elif%20cmp_opt.value%20%3D%3D%20%22in%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20op_str%20%3D%20%22in%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result%20%3D%20d1%20in%20d2%0A%20%20%20%20%20%20%20%20%20%20%20%20elif%20cmp_opt.value%20%3D%3D%20%22gt%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20op_str%20%3D%20%22%3E%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result%20%3D%20d1%20%3E%20d2%0A%20%20%20%20%20%20%20%20%20%20%20%20elif%20cmp_opt.value%20%3D%3D%20%22lt%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20op_str%20%3D%20%22%3C%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result%20%3D%20d1%20%3C%20d2%0A%0A%20%20%20%20%20%20%20%20except%20(TypeError%2C%20NotImplementedError)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20result%20%3D%20None%0A%20%20%20%20%20%20%20%20%20%20%20%20result_text%20%3D%20%22error%22%0A%0A%20%20%20%20%20%20%20%20if%20result_text%20is%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20result%20%3D%3D%20True%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result_text%20%3D%20%22true%22%0A%20%20%20%20%20%20%20%20%20%20%20%20elif%20result%20%3D%3D%20False%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result_text%20%3D%20%22false%22%0A%20%20%20%20%20%20%20%20%20%20%20%20elif%20result%20is%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20result_text%20%3D%20%22unknown%22%0A%0A%20%20%20%20%20%20%20%20return%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22date1%22%3A%20str(d1)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22date2%22%3A%20str(d2)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22result%22%3A%20result%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22result_str%22%3A%20result_text%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20construct%20a%20text%20version%20of%20the%20comparison%20so%20direction%20is%20clear%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20for%20comparisons%20where%20it%20matters%0A%20%20%20%20%20%20%20%20%20%20%20%20%22text%22%3A%20f%22%7Bd1%7D%20%7Bop_str%7D%20%7Bd2%7D%20%3F%20%7Bresult_text%7D%22%2C%0A%20%20%20%20%20%20%20%20%7D%0A%0A%0A%20%20%20%20results%20%3D%20%5B%5D%0A%20%20%20%20%23%20compare%20each%20pair%20of%20dates%0A%20%20%20%20for%20d1%2C%20d2%20in%20combinations(sample_dates%2C%202)%3A%0A%20%20%20%20%20%20%20%20%23%20compare%20both%20directions%0A%20%20%20%20%20%20%20%20results.append(compare(d1%2C%20d2))%0A%20%20%20%20%20%20%20%20results.append(compare(d2%2C%20d1))%0A%0A%20%20%20%20%23%20also%20do%20self%20comparison%0A%20%20%20%20for%20d1%20in%20sample_dates%3A%0A%20%20%20%20%20%20%20%20results.append(compare(d1%2C%20d1))%0A%0A%20%20%20%20date_comparison_df%20%3D%20pl.DataFrame(data%3Dresults)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22This%20chart%20shows%20the%20results%20for%20comparisons%20across%20a%20set%20of%20%60Undate%60%20objects%20with%20varying%20precision%20and%20known%20information.%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20cmp_opt%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.ui.altair_chart(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20alt.Chart(date_comparison_df)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20.mark_rect()%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20y%3Dalt.Y(%22date1%22%2C%20title%3D%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20x%3Dalt.X(%22date2%22%2C%20title%3D%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20color%3Dalt.Color(%22result_str%22%2C%20title%3D%22Result%22).scale(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20domain%3D%5B%22true%22%2C%20%22false%22%2C%20%22error%22%2C%20%22unknown%22%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20range%3D%5B%22%234c78a8%22%2C%20%22%23e45756%22%2C%20%22%23f58518%22%2C%20%22%23bab0ac%22%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20tooltip%3D%22text%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20.properties(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20title%3Df%22Date%20comparisions%20for%3A%20%7Bcmp_opt.value%7D%22%2C%20width%3D900%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20align%3D%22center%22%2C%0A%20%20%20%20)%0A%20%20%20%20%23%20NOTE%3A%20may%20need%20to%20adjust%20dates%20included%20to%20avoid%20undate%20bugs%20with%20unknown%20years%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20mo%2C%20pl)%3A%0A%20%20%20%20from%20undate%20import%20UndateInterval%0A%0A%20%20%20%20nineteenth_c%20%3D%20UndateInterval(Undate(1801)%2C%20Undate(1900)%2C%20label%3D%2219th%20century%22)%0A%20%20%20%20before_2000%20%3D%20UndateInterval(latest%3DUndate(2000)%2C%20label%3D%22Before%202000%22)%0A%20%20%20%20after_1900%20%3D%20UndateInterval(Undate(1900)%2C%20label%3D%22After%201900%22)%0A%0A%20%20%20%20%23%20initialize%20data%20with%20some%20sample%20dates%3B%20display%20on%20next%20slide%20with%20text%0A%20%20%20%20sample_intervals%20%3D%20%5Bnineteenth_c%2C%20before_2000%2C%20after_1900%5D%0A%20%20%20%20%23%20sample_dates.append(datetime.date(**option_values%5B0%5D))%0A%20%20%20%20sample_intervals_df%20%3D%20pl.DataFrame(%0A%20%20%20%20%20%20%20%20data%3D%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22label%22%3A%20%5Bi.label%20for%20i%20in%20sample_intervals%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22interval%22%3A%20sample_intervals%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22earliest%22%3A%20%5Bi.earliest%20for%20i%20in%20sample_intervals%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22latest%22%3A%20%5Bi.latest%20for%20i%20in%20sample_intervals%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22duration%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20repr(i.duration())%20if%20i.earliest%20and%20i.latest%20else%20None%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20for%20i%20in%20sample_intervals%0A%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22duration_days%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20i.duration().days%20if%20i.earliest%20and%20i.latest%20else%20None%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20for%20i%20in%20sample_intervals%0A%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Date%20Intervals%0A%0A%20%20%20%20Like%20many%20other%20date%20libraries%2C%20%60undate%60%20includes%20support%20for%20intervals.%20%20An%20%60UndateInterval%60%20is%20a%20date%20range%20between%20two%20%60Undate%60%20objects.%20Intervals%20can%20be%20open-ended%2C%20allow%20for%20optional%20labels%2C%20and%20can%20calculate%20duration%20if%20enough%20information%20is%20known.%0A%0A%20%20%20%20%60%60%60python%0A%20%20%20%20from%20undate%20import%20UndateInterval%0A%0A%20%20%20%20nineteenth_c%20%3D%20UndateInterval(Undate(1801)%2C%20Undate(1900)%2C%20label%3D%2219th%20century%22)%0A%20%20%20%20before_2000%20%3D%20UndateInterval(latest%3DUndate(2000)%2C%20label%3D%22Before%202000%22)%0A%20%20%20%20after_1900%20%3D%20UndateInterval(Undate(1900)%2C%20label%3D%22After%201900%22)%0A%20%20%20%20%60%60%60%0A%0A%20%20%20%20An%20%60UndateInterval%60%20has%20an%20earliest%20and%20a%20latest%20value%20for%20the%20start%20and%20end%20of%20the%20date%20range.%20Since%20those%20are%20%60Undate%60%20instances%2C%20they%20also%20have%20earliest%20and%20latest%20values.%20The%20duration%20of%20an%20interval%20is%20calculated%20based%20on%20the%20difference%20between%20the%20last%20day%20and%20first%20day%20in%20range.%0A%20%20%20%20%60%60%60%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20sample_intervals_df%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%20(UndateInterval%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Parsing%20dates%20in%20supported%20formats%0A%0A%20%20%20%20Initializing%20an%20%60Undate%60%20directly%20with%20year%2C%20month%2C%20day%20values%20is%20useful%2C%20but%20often%20we%20want%20to%20parse%20text%20dates%20in%20known%20formats%20directly%20and%20work%20with%20them%20as%20data.%0A%0A%20%20%20%20The%20%60undate%60%20library%20has%20an%20extensive%20converter%20class%20(%5B%60BaseDateConverter%60%5D(https%3A%2F%2Fundate-python.readthedocs.io%2Fen%2Flatest%2Fundate%2Fconverters.html))%2C%20which%20can%20be%20extended%20for%20parsing%20dates%20in%20specific%20formats%20and%20also%20for%20parsing%20and%20converting%20dates%20from%20other%20calendars.%20%20Parsing%20is%20implemented%20with%20the%20Python%20library%20%5BLark%5D(https%3A%2F%2Flark-parser.readthedocs.io%2Fen%2Fstable%2F).%0A%0A%20%20%20%20Currently%2C%20%60undate%60%20supports%20**ISO8601**%20and%20some%20portions%20of%20the%20**Extended%20Date%20Time%20Format%20(EDTF)**.%0A%20%20%20%20%22%22%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20pl)%3A%0A%20%20%20%20from%20undate.date%20import%20DatePrecision%0A%20%20%20%20from%20undate.converters.iso8601%20import%20ISO8601DateFormat%0A%0A%20%20%20%20Undate.DEFAULT_CONVERTER%20%3D%20%22ISO8601%22%0A%0A%20%20%20%20parse_dates_txt%20%3D%20%5B%221985-04-12%22%2C%20%221985-04%22%2C%20%221985%22%2C%20%22--04-12%22%5D%0A%20%20%20%20parse_dates%20%3D%20%5BUndate.parse(d%2C%20%22ISO8601%22)%20for%20d%20in%20parse_dates_txt%5D%0A%0A%20%20%20%20%23%20sample_dates.append(datetime.date(**option_values%5B0%5D))%0A%20%20%20%20parse_examples_df%20%3D%20pl.DataFrame(%0A%20%20%20%20%20%20%20%20data%3D%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22input%22%3A%20parse_dates_txt%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22repr%22%3A%20%5Brepr(d)%20for%20d%20in%20parse_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22str%22%3A%20%5Bstr(d)%20for%20d%20in%20parse_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22precision%22%3A%20%5Bstr(d.precision)%20for%20d%20in%20parse_dates%5D%2C%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20)%0A%20%20%20%20return%20ISO8601DateFormat%2C%20parse_examples_df%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20parse_examples_df)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%23%20ISO8601%0A%0A%20%20%20%20**ISO%208601**%20is%20an%20international%20standard%20for%20dates%20(see%20%5BWikipedia%20ISO%208601%20entry%5D(https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FISO_8601)%20for%20more%20details).%20For%20Calendar%20dates%2C%20this%20format%20uses%20the%20familiar%20**YYYY-MM-DD**%20notation%20for%20full%20dates%2C%20**YYYY-MM**%20for%20year%20and%20month.%20Some%20earlier%20versions%20of%20the%20specification%20allowed%20formats%20like%20**--MM-DD**%20for%20dates%20when%20month%20and%20day%20are%20known%20but%20the%20year%20is%20not.%20A%20converter%20can%20be%20used%20directly%20by%20the%20class%2C%20or%20can%20be%20parsed%20by%20the%20name%20of%20the%20converter.%0A%0A%20%20%20%20In%20these%20examples%2C%20we%20set%20the%20default%20converter%20to%20ISO8601%20so%20that%20the%20string%20format%20will%20serialize%20the%20date%20back%20out%20to%20the%20original%20format.%20It%20is%20also%20possible%20to%20output%20in%20a%20different%20format.%0A%0A%20%20%20%20%60%60%60python%0A%20%20%20%20from%20undate.date%20import%20DatePrecision%0A%20%20%20%20from%20undate.converters.iso8601%20import%20ISO8601DateFormat%0A%0A%20%20%20%20Undate.DEFAULT_CONVERTER%20%3D%20%22ISO8601%22%0A%20%20%20%20parse_dates_txt%20%3D%20%5B%221985-04-12%22%2C%20%221985-04%22%2C%20%221985%22%2C%20%22--04-12%22%2C%20%221984%2F1986%22%5D%0A%20%20%20%20parse_dates%20%3D%20%5BUndate.parse(d%2C%20%22ISO8601%22)%20for%20d%20in%20parse_dates_txt%5D%0A%20%20%20%20%60%60%60%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20parse_examples_df%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20If%20you%20try%20to%20parse%20something%20that%20isn't%20supported%20by%20the%20format%20or%20the%20parser%2C%20the%20method%20raises%20a%20%60ValueError%60%20exception%20with%20the%20error%20message%20from%20the%20parser.%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%22%22%0A%20%20%20%20%60%60%60python%0A%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20Undate.parse(%22%3F%3F%3F%3F-04-12%22%2C%20%22ISO8601%22)%0A%20%20%20%20except%20ValueError%20as%20err%3A%0A%20%20%20%20%20%20%20%20print(err)%0A%20%20%20%20%60%60%60%0A%20%20%20%20%60invalid%20literal%20for%20int()%20with%20base%2010%3A%20'%3F%3F%3F%3F'%60%0A%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Undate%2C%20UndateInterval%2C%20pl)%3A%0A%20%20%20%20Undate.DEFAULT_CONVERTER%20%3D%20%22EDTF%22%0A%0A%20%20%20%20parse_edtf_dates%20%3D%20%5B%0A%20%20%20%20%20%20%20%20%221985-04-12%22%2C%0A%20%20%20%20%20%20%20%20%221985-04%22%2C%0A%20%20%20%20%20%20%20%20%221985%22%2C%0A%20%20%20%20%20%20%20%20%22XXXX-04-12%22%2C%0A%20%20%20%20%20%20%20%20%221964%2F2008%22%2C%0A%20%20%20%20%20%20%20%20%222004-02-01%2F2005-02%22%2C%0A%20%20%20%20%20%20%20%20%222005%2F2006-02%22%2C%0A%20%20%20%20%20%20%20%20%221985-04-12%2F..%22%2C%0A%20%20%20%20%20%20%20%20%22-1985%22%2C%0A%20%20%20%20%20%20%20%20%22Y170000002%22%2C%0A%20%20%20%20%5D%0A%20%20%20%20parsed_edtf_dates%20%3D%20%5BUndate.parse(d%2C%20%22EDTF%22)%20for%20d%20in%20parse_edtf_dates%5D%0A%0A%0A%20%20%20%20def%20precision(date)%3A%0A%20%20%20%20%20%20%20%20%23%20display%20date%20precision%20for%20undate%20or%20start%2Fend%20of%20undate%20interval%0A%20%20%20%20%20%20%20%20if%20isinstance(date%2C%20Undate)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20str(date.precision)%0A%20%20%20%20%20%20%20%20elif%20isinstance(date%2C%20UndateInterval)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20parts%20%3D%20%5B%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20date.earliest%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20parts.append(str(date.earliest.precision))%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20date.latest%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20parts.append(str(date.latest.precision))%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20%22%20%2F%20%22.join(parts)%0A%0A%0A%20%20%20%20%23%20sample_dates.append(datetime.date(**option_values%5B0%5D))%0A%20%20%20%20parse_edtf_examples_df%20%3D%20pl.DataFrame(%0A%20%20%20%20%20%20%20%20data%3D%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22input%22%3A%20parse_edtf_dates%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22repr%22%3A%20%5Brepr(d)%20for%20d%20in%20parsed_edtf_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22str%22%3A%20%5Bstr(d)%20for%20d%20in%20parsed_edtf_dates%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22precision%22%3A%20%5Bprecision(d)%20for%20d%20in%20parsed_edtf_dates%5D%2C%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20)%0A%20%20%20%20return%20(parse_edtf_examples_df%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20parse_edtf_examples_df)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%23%20Extended%20Date%20Time%20Format%0A%0A%20%20%20%20Since%20the%20EDTF%20format%20includes%20both%20dates%20and%20intervals%2C%20parsing%20an%20EDTF%20can%20return%20either%20an%20%60Undate%60%20or%20an%20%60UndateInterval%60.%20%20%0A%0A%20%20%20%20EDTF%20and%20ISO8601%20use%20the%20same%20format%20for%20full%20precision%20day%2C%20year-month%2C%20and%20year%20dates.%0A%0A%20%20%20%20EDTF%20uses%20**X**%20to%20indicate%20unspecified%20digits.%20%20EDTF%20also%20supports%20negative%20years%20and%20years%20that%20are%20more%20than%20four%20digits%3B%20the%20**Y**%20prefix%20is%20used%20to%20indicate%20the%20number%20is%20a%20year.%0A%0A%20%20%20%20The%20EDTF%20format%20includes%20notation%20for%20intervals%2C%20including%20open%20intervals%3B%20parsing%20an%20EDTF%20interval%20returns%20an%20%60UndateInterval%60.%20Here%20are%20some%20examples%20from%20the%20Library%20of%20Congress%20documentation%20on%20EDTF.%20Note%20that%20the%20start%20and%20end%20date%20of%20the%20interval%20don't%20have%20to%20use%20the%20same%20date%20precision.%0A%20%20%20%20%60%60%60python%0A%0A%20%20%20%20parse_edtf_dates%20%3D%20%5B%221985-04-12%22%2C%221985-04%22%2C%221985%22%2C%20%22XXXX-04-12%22%2C%20%221964%2F2008%22%2C%0A%20%20%20%20%20%20%20%20%222004-02-01%2F2005-02%22%2C%20%222005%2F2006-02%22%2C%20%221985-04-12%2F..%22%2C%20%22-1985%22%2C%20%22Y170000002%22%5D%0A%20%20%20%20parsed_edtf_dates%20%3D%20%5BUndate.parse(d%2C%20%22EDTF%22)%20for%20d%20in%20parse_edtf_dates%5D%0A%20%20%20%20%60%60%60%0A%0A%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20parse_edtf_examples_df%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Calendars%0A%0A%20%20%20%20%60undate%60%20includes%20a%20%5BBaseCalendarConverter%5D(https%3A%2F%2Fundate-python.readthedocs.io%2Fen%2Flatest%2Fundate%2Fconverters.html%23undate.converters.base.BaseCalendarConverter)%2C%20as%20a%20special%20case%20of%20the%20%60BaseDateConverter%60%20for%20format%20parsing%20and%20conversion%20like%20ISO8601%20and%20EDTF.%20In%20addition%20the%20%60parse()%60%20method%20that%20all%20converters%20must%20implement%2C%20calendar%20converters%20have%20logic%20for%20returning%20minimum%20and%20maximum%20month%20and%20day%2C%20first%20and%20last%20month%20as%20integers%20(since%20some%20calendars%20don't%20start%20the%20year%20on%20month%201)%2C%20and%20a%20%60to_gregorian()%60%20method%20to%20convert%20into%20a%20standard%20Gregorian%20date.%20%60undate%60%20usees%20the%20%5Bconvertdate%5D(https%3A%2F%2Fgithub.com%2Ffitnr%2Fconvertdate)%20Python%20library%20for%20the%20actual%20numeric%20conversion.%0A%0A%20%20%20%20Supported%20calendars%3A%0A%0A%20%20%20%20-%20Gregorian%0A%20%20%20%20-%20Islamic%20Hijri%0A%20%20%20%20-%20Hebrew%20Anno%20Mundi%0A%20%20%20%20-%20Seleucid%20Hebrew%20calendar%0A%0A%0A%20%20%20%20An%20%60Undate%60%20instance%20always%20has%20a%20calendar%20defined%3B%20it%20uses%20the%20Gregorian%20calendar%20if%20a%20calendar%20is%20not%20specified.%20%20You%20may%20have%20noticed%20this%20in%20the%20output%20from%20%60repr()%60%20in%20the%20earlier%20examples.%0A%0A%20%20%20%20%60undate%60%20preserves%20the%20numeric%20values%20of%20the%20date%20in%20the%20original%20calendar%2C%20but%20internally%20converts%20to%20Gregorian%20calendar%20for%20comparison%20with%20other%20dates.%20%60Undate%60%20instances%20with%20different%20calendars%20can%20be%20used%20together.%0A%0A%20%20%20%20This%20means%20that%20two%20%60Undate%60%20objects%20with%20the%20same%20numeric%20day%2C%20month%2C%20and%20year%20values%20represent%20different%20dates%20if%20they%20use%20different%20calendars.%20%20This%20also%20means%20that%20we%20can%20preserve%20the%20precision%20of%20the%20date%20in%20the%20original%20calendar%20(such%20as%20a%20month%20or%20a%20year)%2C%20even%20when%20that%20doesn't%20neatly%20map%20to%20a%20month%20or%20year%20in%20the%20Gregorian%20calendar%20and%20even%20if%20a%20month%20or%20year%20has%20a%20different%20number%20of%20days%20than%20we're%20used%20to.%0A%20%20%20%20%22%22%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20mo%2C%20pl)%3A%0A%20%20%20%20calendars%20%3D%20%5B%22Gregorian%22%2C%20%22Hebrew%22%2C%20%22Islamic%22%5D%0A%0A%20%20%20%20calendar_dates%20%3D%20%7B%0A%20%20%20%20%20%20%20%20%22label%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%2221%20Rajab%201023%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Rajab%201023%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%221023%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%223%20Tishrei%205370%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Tishrei%205370%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%225370%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%222%20June%201663%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22June%201663%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%221663%22%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%22calendar%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Islamic%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Islamic%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Islamic%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Hebrew%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Hebrew%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Hebrew%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Gregorian%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Gregorian%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22Gregorian%22%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%23%20we%20pre-supply%20the%20numeric%20values%20in%20this%20case%2C%20since%20we%20don't%20yet%20have%20a%20text%20parser%20for%20Gregorian%20dates%0A%20%20%20%20%20%20%20%20%22numeric%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20(1023%2C%207%2C%2021)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(1023%2C%207)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(1023%2C)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(5370%2C%207%2C%203)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(5370%2C%207)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(5370%2C)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(1663%2C%206%2C%202)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(1663%2C%206)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(1663%2C)%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%7D%0A%0A%20%20%20%20cal_dates_df%20%3D%20(%0A%20%20%20%20%20%20%20%20pl.from_dict(calendar_dates)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20initialize%20an%20undate%20by%20parsing%20text%20values%20with%20specified%20calendar%0A%20%20%20%20%20%20%20%20%20%20%20%20undate%3Dpl.struct(%22numeric%22%2C%20%22calendar%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20row%3A%20Undate(*row%5B%22numeric%22%5D%2C%20calendar%3Drow%5B%22calendar%22%5D)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.Object%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20string%20representation%20of%20how%20you%20would%20initialize%20an%20undate%20object%20with%20numbers%20and%20calendar%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_str%3Dpl.struct(%22numeric%22%2C%20%22calendar%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20row%3A%20f'Undate(%7B%22%2C%20%22.join(%5Bstr(n)%20for%20n%20in%20row%5B%22numeric%22%5D%5D)%7D%2C%20calendar%3D%22%7Brow%5B%22calendar%22%5D%7D%22)'%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20additional%20columns%20based%20on%20undate%20object%0A%20%20%20%20%20%20%20%20%20%20%20%20precision%3Dpl.col(%22undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20str(x.precision).lower()%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20earliest_gregorian%3Dpl.col(%22undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.earliest%2C%20return_dtype%3Dpl.datatypes.Object%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20latest_gregorian%3Dpl.col(%22undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.latest%2C%20return_dtype%3Dpl.datatypes.Object%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20duration%3Dpl.col(%22undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.duration().days%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20if%20isinstance(x.duration().days%2C%20int)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20handle%20uninteger%3B%20choose%20minimal%20value%20for%20now%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20else%20min(x.duration().days)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.Int32%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20).drop(%22numeric%22)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22This%20table%20shows%20dates%20with%20varying%20precision%20from%20three%20different%20calendars%2C%20with%20their%20numeric%20values%20in%20the%20original%20calendar%20and%20earliest%20and%20latest%20Gregorian%20dates.%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20cal_dates_df%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(datetime%2C%20mo%2C%20pd)%3A%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%23%23%20Implementation%20details%20%0A%0A%20%20%20%20Internally%2C%20we%20use%20%60numpy.datetime64%60%20and%20%60numpy.timedelta64%60%20to%20store%20converted%20dates%3B%20we%20implemented%20shims%20to%20make%20these%20objects%20look%20a%20bit%20more%20like%20the%20builtin%20python%20%60datetime.date%60%20and%20%60datetime.timedelta%60%20objects%2C%20since%20they%20are%20easier%20to%20work%20with%20and%20the%20first%20version%20of%20%60undate%60%20used%20them.%0A%0A%20%20%20%20We%20switched%20to%20%60numpy%60%20for%20dates%20so%20that%20we%20could%20support%20a%20wider%20range%20of%20years.%20%20%0A%0A%20%20%20%20Python%20%60datetime.date%60%20only%20supports%20four-digit%20positive%20years%20(1-9999).%0A%0A%20%20%20%20The%20popular%20data%20analysis%20library%20**Pandas**%20is%20much%20more%20limited%20-%20in%20spite%20of%20using%20%60numpy.datetime64%60%20internally%2C%20Pandas%20methods%20for%20parsing%20dates%20and%20converting%20to%20Timestamp%20objects%20don%E2%80%99t%20support%20dates%20before%201677AD.%0A%0A%20%20%20%20In%20contrast%2C%20%60numpy.datetime64%60%20supports%20a%20range%20of%202.5e16%20BC%2C%202.5e16%20AD%20(see%20%5BNumPy%20Datetime%20units%20documentation%5D(https%3A%2F%2Fnumpy.org%2Fdoc%2Fstable%2Freference%2Farrays.datetime.html%23datetime-units)).%0A%0A%0A%20%20%20%20%7C%20Implementation%20%7C%20Minimum%20year%20(code)%20%7C%20%20Maximum%20year%20(code)%20%7C%20Minimum%20year%20%7C%20%20Maximum%20year%20%7C%0A%20%20%20%20%7C%20-------------%3A%20%7C%20%3A----------%3A%20%7C%20%3A-----------%3A%20%7C%20%3A----------%3A%20%7C%20%3A-----------%3A%20%7C%0A%20%20%20%20%7C%20%60datetime.date%60%20%7C%20%60datetime.MINYEAR%60%20%7C%20%60datetime.MAXYEAR%60%20%7C%20%7Bdatetime.MINYEAR%7D%20%7C%20%7Bdatetime.MAXYEAR%7D%20%7C%0A%20%20%20%20%7C%20%60pandas.Timestamp%60%20%7C%20%60pd.Timestamp.min.year%60%20%7C%20%60pd.Timestamp.max.year%60%20%7C%20%7Bpd.Timestamp.min.year%7D%20%7C%20%7Bpd.Timestamp.max.year%7D%20%7C%0A%20%20%20%20%7C%20%60numpy.datetime64%5BD%5D%60%20%7C%20-%20%7C%20-%20%7C%202.5e16%20BC%20%7C%202.5e16%20AD%20%7C%0A%20%20%20%20%22%22%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Example%20use%20cases%0A%0A%20%20%20%20%23%23%23%20Shakespeare%20and%20Company%20Project%20%0A%0A%20%20%20%20The%20%5BShakespeare%20and%20Company%20Project%5D(https%3A%2F%2Fshakespeareandco.princeton.edu%2F)%20is%20a%20research%20project%20based%20on%20records%20from%20Sylvia%20Beach%E2%80%99s%20famous%201920s%20and%201930s%20bookshop%20and%20lending%20library%20in%20Paris%20to%20reveal%20the%20reading%20practices%20of%20the%20influential%20writers%2C%20artists%2C%20intellectuals%2C%20and%20students%20who%20lived%20in%20Paris%20between%20the%20two%20world%20wars.%20Shakespeare%20and%20Company%20was%20an%20English-language%20lending%20library%20and%20bookshop%2C%20and%20Beach's%20papers%20include%20an%20incomplete%20set%20of%20lending%20library%20cards%20documenting%20what%20books%20members%20borrowed%20and%20when.%0A%0A%20%20%20%20This%20project%20is%20based%20on%20relatively%20recent%20materials%2C%20but%20in%20spite%20of%20that%20fact%20much%20of%20the%20infomration%20is%20imprecise%20and%20imperfect%2C%20as%20they%20were%20written%20by%20Beach%20and%20her%20assistants%20to%20run%20a%20business%20%E2%80%94%20they%20didn't%20always%20write%20full%20titles%20down%20because%20they%20knew%20what%20books%20they%20had%20available.%20And%20in%20some%20cases%2C%20they%20also%20didn't%20record%20the%20year%20for%20the%20borrowing%20records%3B%20for%20example%2C%20this%20portion%20of%20Gertrude%20Stein's%20borrowing%20history%2C%20which%20includes%20months%20and%20days%20but%20no%20years%3A%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20Render%20an%20local%20image%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.image(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20src%3D%22public%2Fstein_lendingcard_unknownyear.jpg%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20alt%3D%22Detail%20from%20one%20of%20Gertrude%20Stein's%20lending%20library%20cards%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20width%3D%2270%25%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20caption%3D%22Gertrude%20Stein%20borrowing%20activity%2C%20unknown%20year%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(r%22%22%22This%20project%20provides%20an%20example%20of%20how%20partially%20unknown%20dates%20can%20still%20be%20computationally%20useful.%20If%20we%20make%20the%20reasonable%20assumption%20that%20for%20borrowing%20activity%20like%20this%2C%20with%20an%20unknown%20year%2C%20books%20were%20returned%20in%20the%20same%20or%20following%20year%2C%20then%20we%20can%20calculate%20how%20long%20the%20books%20were%20borrowed%20and%20include%20them%20in%20analysis%20of%20library%20member%20activities.%0A%0A%20%20%20%20Here%20I%20demonstrate%20this%20using%20borrowing%20events%20from%20the%20Shakespeare%20and%20Company%20Project%202.0%20dataset.%0A%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20align%3D%22center%22%2C%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(ISO8601DateFormat%2C%20NOTEBOOK_PUBLIC_DIR%2C%20Undate%2C%20UndateInterval%2C%20mo%2C%20pl)%3A%0A%20%20%20%20from%20undate.date%20import%20ONE_DAY%0A%0A%20%20%20%20%23%20load%20a%20filtered%20set%20of%20data%20from%202.0%20version%20of%20S%26co%20events%20data%20from%20the%20public%20folder%0A%20%20%20%20%23%20NOTE%3A%20data%20has%20been%20prefiltered%20for%20efficiency%3B%20borrow%20events%20only%2C%20with%20start%20and%20end%20dates%2C%0A%20%20%20%20%23%20and%20a%20subset%20of%20relevant%20fields.%20See%20filter_data%20script%20for%20specifics.%0A%20%20%20%20borrow_events%20%3D%20(%0A%20%20%20%20%20%20%20%20pl.read_csv(str(NOTEBOOK_PUBLIC_DIR%20%2F%20%22SCoData_borrows_events.csv%22))%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20start_undate%3Dpl.col(%22start_date%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20Undate.parse(x%2C%20%22ISO8601%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.Object%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20end_undate%3Dpl.col(%22end_date%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20Undate.parse(x%2C%20%22ISO8601%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.Object%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20start_date_precision%3Dpl.col(%22start_undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20str(x.precision)%2C%20return_dtype%3Dpl.datatypes.String%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20end_date_precision%3Dpl.col(%22end_undate%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20str(x.precision)%2C%20return_dtype%3Dpl.datatypes.String%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.filter(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20filter%20to%20day-level%20precision%20since%20that's%20currently%20needed%20to%20calculate%20duration%0A%20%20%20%20%20%20%20%20%20%20%20%20pl.col(%22start_date_precision%22).eq(%22DAY%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20pl.col(%22end_date_precision%22).eq(%22DAY%22)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%0A%0A%20%20%20%20def%20undate_duration(start_date%2C%20end_date)%3A%0A%20%20%20%20%20%20%20%20%23%20treat%20a%20same-day%20return%20as%20a%20one%20day%20borrow%0A%20%20%20%20%20%20%20%20if%20start_date%20%3D%3D%20end_date%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20ONE_DAY%0A%20%20%20%20%20%20%20%20isoformat%20%3D%20ISO8601DateFormat()%0A%0A%20%20%20%20%20%20%20%20unstart%20%3D%20isoformat.parse(start_date)%0A%20%20%20%20%20%20%20%20unend%20%3D%20isoformat.parse(end_date)%0A%20%20%20%20%20%20%20%20%23%20if%20start%20year%20is%20known%20but%20end%20is%20not%2C%20make%20them%20both%20unknown%0A%20%20%20%20%20%20%20%20%23%20(assume%20same%2Fsubsequent%20year)%0A%20%20%20%20%20%20%20%20if%20unstart.known_year%20and%20(not%20unend.known_year)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20unstart%20%3D%20Undate(month%3Dunstart.month%2C%20day%3Dunstart.day)%0A%20%20%20%20%20%20%20%20interval%20%3D%20UndateInterval(earliest%3Dunstart%2C%20latest%3Dunend)%0A%0A%20%20%20%20%20%20%20%20%23%20borrow%20durations%20in%20Shakespeare%20and%20Company%20Project%20were%20defined%20as%20not%20including%20both%20ends%20(or%20half%20both%20ends)%0A%20%20%20%20%20%20%20%20%23%20to%20reconcile%20differences%20between%20duration%20logic%20with%20undate%2C%20which%20includes%20both%20endpoints%2C%20we%20subtract%20one%20day%0A%20%20%20%20%20%20%20%20return%20(interval.duration()%20-%20ONE_DAY).days%0A%0A%0A%20%20%20%20%23%20calculate%20durations%3B%20returns%20a%20dataframe%20with%20one%20column%0A%20%20%20%20duration_df%20%3D%20borrow_events.select(%22start_date%22%2C%20%22end_date%22).map_rows(%0A%20%20%20%20%20%20%20%20lambda%20x%3A%20undate_duration(x%5B0%5D%2C%20x%5B1%5D)%2C%20return_dtype%3Dpl.datatypes.Int32%0A%20%20%20%20)%0A%0A%20%20%20%20%23%20add%20fields%20to%20the%20main%20dataframe%20for%20duration%20and%20whether%20year%20is%20known%0A%20%20%20%20borrow_events%20%3D%20borrow_events.with_columns(%0A%20%20%20%20%20%20%20%20undate_duration%3Dduration_df%5B%22map%22%5D%2C%0A%20%20%20%20%20%20%20%20known_year%3Dborrow_events%5B%22start_undate%22%5D.map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20%22known%22%20if%20x.known_year%20else%20%22unknown%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22This%20subset%20of%20the%20borrowing%20data%20shows%20events%20with%20dates%20but%20no%20known%20year.%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20borrow_events.head(10)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%20(borrow_events%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(alt)%3A%0A%20%20%20%20def%20raincloud_plot(dataset%2C%20fieldname%2C%20field_label%2C%20color_opts%3DNone)%3A%0A%20%20%20%20%20%20%20%20%22%22%22Create%20a%20raincloud%20plot%20for%20the%20density%20of%20the%20specified%20field%0A%20%20%20%20%20%20%20%20in%20the%20given%20dataset.%20Takes%20an%20optional%20tooltip%20for%20the%20strip%20plot.%0A%20%20%20%20%20%20%20%20Returns%20an%20altair%20chart.%22%22%22%0A%0A%20%20%20%20%20%20%20%20%23%20create%20a%20density%20area%20plot%20of%20specified%20fieldname%0A%0A%20%20%20%20%20%20%20%20duration_density%20%3D%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.Chart(dataset)%0A%20%20%20%20%20%20%20%20%20%20%20%20.transform_density(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20fieldname%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20as_%3D%5Bfieldname%2C%20%22density%22%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20.mark_area(orient%3D%22vertical%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20x%3Dalt.X(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20fieldname%2C%20title%3DNone%2C%20axis%3Dalt.X(labels%3DFalse%2C%20ticks%3DFalse)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20y%3Dalt.Y(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22density%3AQ%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20suppress%20labels%20and%20ticks%20because%20we're%20going%20to%20combine%20this%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20title%3DNone%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20axis%3Dalt.Axis(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20labels%3DFalse%2C%20values%3D%5B0%5D%2C%20grid%3DFalse%2C%20ticks%3DFalse%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20.properties(height%3D100%2C%20width%3D800)%0A%20%20%20%20%20%20%20%20)%0A%0A%20%20%20%20%20%20%20%20%23%20Now%20create%20jitter%20plot%20of%20the%20same%20field%0A%20%20%20%20%20%20%20%20%23%20jittering%20%2F%20stripplot%20adapted%20from%20https%3A%2F%2Fstackoverflow.com%2Fa%2F71902446%2F9706217%0A%0A%20%20%20%20%20%20%20%20chart_color_opts%20%3D%20%7B%7D%0A%20%20%20%20%20%20%20%20if%20color_opts%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20chart_color_opts%20%3D%20%7B%22color%22%3A%20color_opts%7D%0A%0A%20%20%20%20%20%20%20%20stripplot%20%3D%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.Chart(dataset)%0A%20%20%20%20%20%20%20%20%20%20%20%20.mark_circle(size%3D50)%0A%20%20%20%20%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20x%3Dalt.X(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20fieldname%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20title%3Dfield_label%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20axis%3Dalt.Axis(labels%3DTrue)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20y%3Dalt.Y(%22jitter%3AQ%22%2C%20title%3DNone%2C%20axis%3DNone)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20**chart_color_opts%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20color%3Dalt.Color(color_by)%2C%20%20%23%20.scale(**color_scale)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20.transform_calculate(jitter%3D%22(random()%20%2F%20200)%20-%200.0052%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20.properties(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20height%3D120%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20width%3D800%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20)%0A%0A%20%20%20%20%20%20%20%20%23%20use%20vertical%20concat%20to%20combine%20the%20two%20plots%20together%0A%20%20%20%20%20%20%20%20raincloud_plot%20%3D%20alt.vconcat(duration_density%2C%20stripplot).configure_concat(%0A%20%20%20%20%20%20%20%20%20%20%20%20spacing%3D0%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20return%20raincloud_plot%0A%20%20%20%20return%20(raincloud_plot%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(borrow_events%2C%20mo%2C%20pl)%3A%0A%20%20%20%20members_with_unknownyears%20%3D%20(%0A%20%20%20%20%20%20%20%20borrow_events.filter(pl.col(%22known_year%22).eq(%22unknown%22))%0A%20%20%20%20%20%20%20%20.select(%22member_names%22)%0A%20%20%20%20%20%20%20%20.unique()%0A%20%20%20%20)%0A%20%20%20%20%23%20get%20counts%20and%20filter%20to%20members%20with%20at%20laest%20two%20borrows%0A%20%20%20%20borrow_counts%20%3D%20borrow_events.group_by(%22member_names%22).len()%0A%20%20%20%20members_with_unknownyears%20%3D%20members_with_unknownyears.join(%0A%20%20%20%20%20%20%20%20borrow_counts%2C%20on%3D%22member_names%22%0A%20%20%20%20).filter(pl.col(%22len%22).gt(2))%0A%0A%20%20%20%20members_with_unknowns%20%3D%20members_with_unknownyears%5B%22member_names%22%5D.to_list()%0A%0A%0A%20%20%20%20member_opt%20%3D%20mo.ui.radio(%0A%20%20%20%20%20%20%20%20options%3Dmembers_with_unknowns%2C%0A%20%20%20%20%20%20%20%20label%3D%22Library%20Member%22%2C%0A%20%20%20%20%20%20%20%20value%3D%22Gertrude%20Stein%22%2C%0A%20%20%20%20)%0A%20%20%20%20return%20(member_opt%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(alt%2C%20borrow_events%2C%20member_opt%2C%20mo%2C%20pl%2C%20raincloud_plot)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%22%22%23%23%23%20Library%20Member%20borrowing%20duration%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20This%20raincloud%20plot%20showing%20the%20distribution%20of%20borrowing%20duration%20for%20members%20with%20borrow%20events%20without%20known%20years.%20%20That%20is%2C%20how%20long%20did%20they%20typically%20keep%20the%20books%20that%20they%20borrowed%3F%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20member_opt%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.ui.altair_chart(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20raincloud_plot(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20filter%20to%20selected%20member%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20borrow_events.filter(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pl.col(%22member_names%22).eq(member_opt.value)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20).select(%22undate_duration%22%2C%20%22known_year%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_duration%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22Borrow%20duration%20in%20days%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20alt.Color(%22known_year%22%2C%20title%3D%22Year%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20).properties(title%3Df%22Borrows%20for%20%7Bmember_opt.value%7D%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22The%20capability%20to%20calculate%20durations%20for%20partially%20known%20dates%20means%20this%20information%20can%20be%20included%20in%20analysis%20and%20interpretation%20of%20member%20borrowing%20activity%2C%20such%20as%20books%20that%20were%20borrowed%20and%20returned%20quickly%20or%20checked%20out%20for%20longer%20times%2C%20and%20included%20in%20broader%20analysis%20of%20borrowing%20behavior%20across%20all%20library%20members%20or%20specific%20individuals.%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(NOTEBOOK_PUBLIC_DIR%2C%20pl)%3A%0A%20%20%20%20%23%20load%20a%20copy%20of%20PGP%20document%20data%20from%20the%20assets%20folder%0A%20%20%20%20%23%20pre-filtered%20to%20documents%20with%20standardized%20format%2C%20supported%20calendars%2C%20and%20subset%20of%20fields%0A%20%20%20%20%23%20see%20filter%20script%20for%20specifics%0A%20%20%20%20docs_with_docdate%20%3D%20pl.read_csv(%0A%20%20%20%20%20%20%20%20str(NOTEBOOK_PUBLIC_DIR%20%2F%20%22pgp_dated_documents.csv%22)%0A%20%20%20%20)%0A%20%20%20%20return%20(docs_with_docdate%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(docs_with_docdate%2C%20mo)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%23%20Princeton%20Geniza%20Project%0A%0A%20%20%20%20The%20%5BPrinceton%20Geniza%20Project%5D(https%3A%2F%2Fgeniza.princeton.edu%2F)%20is%20a%20database%20of%20texts%20that%20were%20preserved%20in%20a%20medieval%20synagogue%20in%20Cairo%2C%20Egypt.%0A%0A%20%20%20%20The%20texts%20are%20predominantly%20written%20in%20Hebrew%20script%2C%20are%20often%20fragmentary%2C%20and%20in%20many%20cases%20they%20are%20difficult%20to%20place%20in%20time.%20Because%20of%20the%20context%20of%20these%20materials%2C%20they%20use%20a%20mix%20of%20calendars.%0A%0A%20%20%20%20This%20part%20of%20the%20notebook%20demonstrate%20%60undate%60%20capabilities%20using%20the%20subset%20of%20documents%20with%20known%20dates.%20%20The%20dataset%20fields%20include%20original%20date%2C%20calendar%2C%20and%20a%20standardized%20date%20(using%20Common%20Era%20dates%3B%20Julian%20calendar%20before%201583%2C%20Gregorian%20after).%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20docs_with_docdate.head(10)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20docs_with_docdate%5B%22doc_date_calendar%22%5D.value_counts()%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20docs_with_docdate%2C%20pl)%3A%0A%20%20%20%20%23%20Use%20undate%20to%20parse%20the%20original%20dates%20based%20on%20calendar%0A%0A%20%20%20%20from%20lark.exceptions%20import%20UnexpectedEOF%2C%20VisitError%0A%0A%0A%20%20%20%20def%20parse_original_date(doc_date_calendar%2C%20doc_date_original)%3A%0A%20%20%20%20%20%20%20%20if%20doc_date_calendar%20%3D%3D%20%22Anno%20Mundi%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_calendar%20%3D%20%22Hebrew%22%0A%20%20%20%20%20%20%20%20elif%20doc_date_calendar%20%3D%3D%20%22Hijr%C4%AB%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_calendar%20%3D%20%22Islamic%22%0A%20%20%20%20%20%20%20%20elif%20doc_date_calendar%20%3D%3D%20%22Seleucid%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_calendar%20%3D%20%22Seleucid%22%0A%0A%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20Undate.parse(doc_date_original%2C%20undate_calendar)%0A%20%20%20%20%20%20%20%20except%20(VisitError%2C%20ValueError%2C%20UnexpectedEOF)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20we%20don't%20support%20parsing%20everything%20in%20this%20dataset%2C%20and%20some%20of%20them%20have%20errors%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20for%20demonstration%20purposes%2C%20ignore%20anything%20we%20can't%20parse%0A%20%20%20%20%20%20%20%20%20%20%20%20pass%0A%0A%0A%20%20%20%20days%20%3D%20%5B%0A%20%20%20%20%20%20%20%20%22Monday%22%2C%0A%20%20%20%20%20%20%20%20%22Tuesday%22%2C%0A%20%20%20%20%20%20%20%20%22Wednesday%22%2C%0A%20%20%20%20%20%20%20%20%22Thursday%22%2C%0A%20%20%20%20%20%20%20%20%22Friday%22%2C%0A%20%20%20%20%20%20%20%20%22Saturday%22%2C%0A%20%20%20%20%20%20%20%20%22Sunday%22%2C%0A%20%20%20%20%5D%0A%0A%0A%20%20%20%20docs_with_undate%20%3D%20(%0A%20%20%20%20%20%20%20%20docs_with_docdate.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_orig%3Dpl.struct(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22doc_date_calendar%22%2C%20%22doc_date_original%22%0A%20%20%20%20%20%20%20%20%20%20%20%20).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20parse_original_date(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20x%5B%22doc_date_calendar%22%5D%2C%20x%5B%22doc_date_original%22%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.Object%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.filter(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20limit%20to%20the%20records%20that%20were%20successfully%20parsed%0A%20%20%20%20%20%20%20%20%20%20%20%20pl.col(%22undate_orig%22).is_not_null()%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20compare%20undate%20standardized%20earliest%2Flatest%20values%20with%20the%20standardized%20dates%20in%20the%20dataset%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_earliest%3Dpl.col(%22undate_orig%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.earliest%2C%20return_dtype%3Dpl.datatypes.Object%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_latest%3Dpl.col(%22undate_orig%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.latest%2C%20return_dtype%3Dpl.datatypes.Object%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20orig_date_precision%3Dpl.col(%22undate_orig%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20str(x.precision).lower()%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20determine%20weekday%20when%20possible%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_weekday%3Dpl.col(%22undate_orig%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20days%5Bx.earliest.weekday%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20if%20x.earliest%20%3D%3D%20x.latest%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20else%20None%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20get%20numeric%20month%20in%20original%20calendar%2C%20when%20known%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_month%3Dpl.col(%22undate_orig%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20lambda%20x%3A%20x.month%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.datatypes.String%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%0A%20%20%20%20docs_with_undate%0A%20%20%20%20return%20days%2C%20docs_with_undate%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(docs_with_undate%2C%20mo)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20We%20can%20compare%20%60undate%60%20standardized%20earliest%2Flatest%20values%20with%20the%20standardized%20dates%20provided%20in%20the%20dataset.%0A%0A%20%20%20%20For%20the%20dates%20before%201583%20we%20expect%20to%20se%20a%20few%20days%20difference%2C%20due%20to%20the%20use%20of%20Julian%20calendar.%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20limit%20and%20order%20fields%20to%20help%20make%20the%20comparison%0A%20%20%20%20%20%20%20%20%20%20%20%20docs_with_undate%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22doc_date_original%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22doc_date_calendar%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_orig%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22doc_date_standard%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_earliest%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_latest%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22orig_date_precision%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_weekday%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20%5D.head(10)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(alt%2C%20docs_with_undate%2C%20pl)%3A%0A%20%20%20%20docs_with_month%20%3D%20docs_with_undate.filter(pl.col(%22undate_month%22).is_not_null())%0A%0A%0A%20%20%20%20pgp_month_calendar_chart%20%3D%20(%0A%20%20%20%20%20%20%20%20alt.Chart(%0A%20%20%20%20%20%20%20%20%20%20%20%20docs_with_month.select(%22undate_month%22%2C%20%22pgpid%22%2C%20%22doc_date_calendar%22)%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.mark_rect()%0A%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.X(%22undate_month%22%2C%20title%3D%22month%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.Color(%22count(pgpid)%22%2C%20title%3D%22%23%20of%20documents%22)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.facet(row%3Dalt.Facet(%22doc_date_calendar%22%2C%20title%3D%22Original%20Calendar%22))%0A%20%20%20%20%20%20%20%20.resolve_scale(color%3D%22independent%22)%0A%20%20%20%20%20%20%20%20.properties(title%3D%22Document%20frequency%20by%20month%20and%20calendar%22)%0A%20%20%20%20)%0A%20%20%20%20return%20(pgp_month_calendar_chart%2C)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20pgp_month_calendar_chart%2C%20pgp_weekday_chart)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20Preserving%20calendar%20and%20date%20information%2C%20we%20can%20now%20do%20some%20analysis%20based%20on%20different%20aspects%20of%20these%20dates.%20%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%22For%20instance%2C%20how%20are%20the%20documents%20distributed%20over%20the%20different%20months%3F%22%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20There's%20a%20month%2013%20that%20doesn't%20exist%20in%20the%20Islamic%20calendar%2C%20shows%20up%20on%20the%20Hebrew%20calendar%20with%20much%20fewer%20documents%20%E2%80%94%20that's%20because%20the%20Hebrew%20calendar%20includes%20a%20leap%20_month_.%20Because%20that%20month%20doesn't%20happen%20every%20year%2C%20we%20would%20expect%20to%20see%20far%20fewer%20documents%20-%20as%20evidenced%20in%20the%20heatmap.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pgp_month_calendar_chart%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pgp_weekday_chart%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22We%20can%20also%20plot%20frequency%20by%20weekday%2C%20for%20documents%20with%20day-level%20precision.%0A%0A%20%20%20%20The%20results%20show%20that%20**Legal%20documents**%20are%20the%20most%20likely%20to%20be%20precisely%20dated.%20%0A%0A%20%20%20%20Monday%20and%20Thursday%20are%20the%20other%20convening%20days%20for%20court%20sessions%2C%20which%20have%20noticeably%20more%20documents.%20Saturday%20is%20the%20Hebrew%20Shabbat%2C%20and%20as%20we%20would%20expect%20there%20are%20fewer%20documents.%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(alt%2C%20days%2C%20docs_with_undate%2C%20pl)%3A%0A%20%20%20%20%23%20filter%20to%20parsed%20dates%20with%20day-level%20precision%0A%20%20%20%20%23%20limit%20by%20document%20type%20for%20types%20with%20enough%20day-precision%20events%20to%20chart%0A%20%20%20%20pgp_weekday_docs%20%3D%20docs_with_undate.filter(%0A%20%20%20%20%20%20%20%20pl.col(%22orig_date_precision%22).eq(%22day%22)%0A%20%20%20%20).filter(%0A%20%20%20%20%20%20%20%20pl.col(%22type%22).is_in(%0A%20%20%20%20%20%20%20%20%20%20%20%20%5B%22Letter%22%2C%20%22Legal%20document%22%2C%20%22State%20document%22%2C%20%22List%20or%20table%22%5D%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%0A%20%20%20%20pgp_weekday_chart%20%3D%20(%0A%20%20%20%20%20%20%20%20alt.Chart(pgp_weekday_docs.select(%22type%22%2C%20%22undate_weekday%22%2C%20%22pgpid%22))%0A%20%20%20%20%20%20%20%20.mark_rect()%0A%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.X(%22undate_weekday%22%2C%20sort%3Ddays%2C%20title%3D%22weekday%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20alt.Color(%22count(pgpid)%22%2C%20title%3D%22%23%20of%20documents%22)%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.facet(%0A%20%20%20%20%20%20%20%20%20%20%20%20row%3Dalt.Facet(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22type%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20title%3D%22%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20header%3Dalt.Header(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20labelAngle%3D0%2C%20labelAnchor%3D%22start%22%2C%20labelBaseline%3D%22bottom%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.resolve_scale(color%3D%22independent%22)%0A%20%20%20%20%20%20%20%20.properties(title%3D%22Document%20frequency%20by%20weekday%22)%0A%20%20%20%20)%0A%20%20%20%20return%20(pgp_weekday_chart%2C)%0A%0A%0A%40app.cell%0Adef%20_(NOTEBOOK_PUBLIC_DIR%2C%20pl)%3A%0A%20%20%20%20sf_time%20%3D%20pl.read_csv(str(NOTEBOOK_PUBLIC_DIR%20%2F%20%22futuristic_fiction.csv%22))%0A%20%20%20%20sf_time_multiyear%20%3D%20sf_time.filter(pl.col(%22multiyears%22).is_not_null())%0A%20%20%20%20return%20sf_time%2C%20sf_time_multiyear%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo%2C%20sf_time%2C%20sf_time_multiyear)%3A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%23%20Time%20Horizons%20of%20Futuristic%20Fiction.%0A%0A%20%20%20%20Humanities%20data%20exceeds%20the%20bounds%20of%20standard%20tooling%20in%20both%20directions%20(past%20and%20future).%20This%20dataset%20provides%20us%20a%20fun%20example%20to%20experiment%20with.%20%20The%20authors%20use%20metadata%20on%20English%20language%20speculative%20fiction%20to%20look%20at%20the%20distance%20in%20time%20between%20a%20work%20was%20released%20and%20when%20it%20is%20set%3B%20that%20is%2C%20how%20far%20in%20the%20future%20are%20authors%20speculating.%0A%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20f%22The%20data%20includes%20%7Bsf_time.height%3A%2C%7D%20records%3B%20%7Bsf_time_multiyear.height%3A%2C%7D%20of%20those%20(%7B(sf_time_multiyear.height%20%2F%20sf_time.height)%20*%20100%3A.1f%7D%25)%20have%20multiple%20years.%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20sf_time%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%22%22%0A%0A%20%20%20%20The%20essay%20published%20with%20this%20data%20explains%20how%20they%20handled%20multi-year%20works%3A%20%20%20%20%20%20%20%20%0A%0A%20%20%20%20%3E%20If%20the%20work%20takes%20place%20over%20a%20wide%20range%20of%20years%20(e.g.%20time%20travel%20or%20multi-generational%20narratives)%2C%20we%20generally%20entered%20the%20**median%20of%20the%20years**%20depicted%20in%20the%20work.%20...%20Formatted%20as%20an%20integer%20rather%20than%20a%20date%20because%20the%20**Python%20datetime%20module%20doesn%E2%80%99t%20support%20years%20beyond%209999**.%20(A%20note%20to%20the%20AIs%20maintaining%20the%20world%E2%80%99s%20code%20in%20the%20distant%20future%3A%20beware%20the%20Y10K%20bug!)%0A%20%20%20%20%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(Undate%2C%20UndateInterval%2C%20mo%2C%20pl%2C%20re%2C%20sf_time_multiyear)%3A%0A%20%20%20%20%23%20next...%20start%20parsing.%20interval%3F%20set%20of%20years%3F%20maybe%20start%20with%20min%2Fmax%20interval%20as%20a%20first%20pass%0A%0A%0A%20%20%20%20def%20parse_multiyear(value)%3A%0A%20%20%20%20%20%20%20%20%23%20print(value)%0A%20%20%20%20%20%20%20%20%23%20handle%20some%20special%20cases%0A%20%20%20%20%20%20%20%20if%20value%20%3D%3D%20%2220th%20century%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%221901%2F2000%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%22Early%20in%20the%2020th%20century%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20based%20on%3A%20%20Early%3A%2000s%2C%2010s%2C%20and%2020s%20Mid%3A%2030s%2C%2040s%2C%2050s%2C%20and%2060s%20Late%3A%2070s%2C%2080s%2C%20and%2090s%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%221901%2F1929%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%22Early%2021st%20century%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%222001%2F2029%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%22The%20late%2020th%20century%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%221970%2F1999%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%22Late%201910s%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%221917%2F1919%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%221990s%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%22199X%22%0A%20%20%20%20%20%20%20%20elif%20value%20%3D%3D%20%221980s-1990s%22%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20%221980%2F1999%22%0A%0A%20%20%20%20%20%20%20%20%23%20a%20couple%20of%20multidigit%20years%20have%20commas%3B%20remove%20them%0A%20%20%20%20%20%20%20%20value%20%3D%20re.sub(r%22(%5Cd%2B)%2C(%5Cd%7B3%7D)%22%2C%20r%22%5C1%5C2%22%2C%20value)%0A%0A%20%20%20%20%20%20%20%20%23%20ignore%20circa%20values%20so%20we%20can%20parse%20(could%20padd...)%0A%20%20%20%20%20%20%20%20if%20%22c.%20%22%20in%20value%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20value.replace(%22c.%20%22%2C%20%22%22)%0A%20%20%20%20%20%20%20%20elif%20%22ca.%20%22%20in%20value%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20value.replace(%22ca.%20%22%2C%20%22%22)%0A%20%20%20%20%20%20%20%20if%20%22%20and%20%22%20in%20value%3A%20%20%23%20one%20value%20has%20and%20instead%20of%20a%20comma%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20value.replace(%22%20and%20%22%2C%20%22%2C%20%22)%0A%0A%20%20%20%20%20%20%20%20%23%20NOTE%3A%20we%20don't%20handle%20range%20and%20comma%3A%201982%2F1983%2C%201988%0A%0A%20%20%20%20%20%20%20%20if%20%22-%22%20in%20value%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20value.replace(%22-%22%2C%20%22%2F%22)%0A%0A%20%20%20%20%20%20%20%20if%20%22%2C%22%20in%20value%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20strip%20out%20non-numerics%3F%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20split%20on%20comma%20or%20%2F%20since%20some%20contain%20both%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20years%20%3D%20%5Bint(v.strip())%20for%20v%20in%20re.split(r%22%2C%7C%2F%22%2C%20value)%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20value%20%3D%20f%22%7Bmin(years)%7D%2F%7Bmax(years)%7D%22%0A%20%20%20%20%20%20%20%20%20%20%20%20except%20ValueError%20as%20err%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20print(err)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%0A%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20interval%20%3D%20Undate.parse(value%2C%20%22EDTF%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20it's%20possible%20that%20this%20returns%20an%20undate%20or%20an%20undate%20interval%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20convert%20to%20an%20interval%20so%20the%20structure%20is%20the%20same%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20isinstance(interval%2C%20Undate)%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20interval%20%3D%20UndateInterval(interval.earliest%2C%20interval.latest)%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20earliest%20%3D%20interval.earliest%0A%20%20%20%20%20%20%20%20%20%20%20%20latest%20%3D%20interval.latest%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20debugging%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20print(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20%20%20%20%20f%22%7Binterval%7D%20%7Binterval.__class__%7D%20earliest%20%7Binterval.earliest%7D%20(%7Binterval.earliest.__class__%7D)%20latest%20%7Binterval.latest%7D%20(%7Binterval.latest.__class__%7D)%22%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20)%0A%20%20%20%20%20%20%20%20%20%20%20%20dictreturn%20%3D%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%23%20nested%20objects%20not%20allowed%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_interval%22%3A%20str(interval)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_earliest%22%3A%20int(earliest.year)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_latest%22%3A%20int(latest.year)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20print(dictreturn)%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20dictreturn%0A%20%20%20%20%20%20%20%20except%20ValueError%20as%20err%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20print(err)%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_interval%22%3A%20None%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_earliest%22%3A%20None%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_latest%22%3A%20None%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%0A%0A%20%20%20%20sf_time_multiyear_undate%20%3D%20(%0A%20%20%20%20%20%20%20%20sf_time_multiyear.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20undate_parsing%3Dpl.col(%22multiyears%22).map_elements(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20parse_multiyear%2C%20%20%23%20return_dtype%3Dpl.Struct%20%23return_dtype%3Dpl.datatypes.Object%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20skip_nulls%3DFalse%2C%20%20%23%20without%2C%20causes%20error%20on%20html%2Bwasm%20version%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return_dtype%3Dpl.Struct(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pl.Field(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_interval%22%2C%20pl.datatypes.String%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%20%20%23%20pl.datatypes.Object)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pl.Field(%22interval_earliest%22%2C%20pl.datatypes.Int64)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pl.Field(%22interval_latest%22%2C%20pl.datatypes.Int64)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.unnest(%22undate_parsing%22)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20years_distant_min%3Dpl.col(%22interval_earliest%22).sub(pl.col(%22released%22))%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20years_distant_max%3Dpl.col(%22interval_latest%22).sub(pl.col(%22released%22))%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20duration%3Dpl.col(%22interval_latest%22).sub(pl.col(%22interval_earliest%22))%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20%20%20%20%20.with_columns(%0A%20%20%20%20%20%20%20%20%20%20%20%20%23%20combined%20years%20distant%20for%20chart%20label%0A%20%20%20%20%20%20%20%20%20%20%20%20pl.format(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%7B%7D%20(%7B%7D%E2%80%94%7B%7D)%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pl.col(%22years_distant%22).cast(pl.Int64)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years_distant_min%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years_distant_max%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20).alias(%22years%20distant%22)%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22In%20this%20filtered%20version%20of%20the%20data%2C%20we've%20used%20%60undate%60%20to%20parse%20the%20**multiyears**%20field%20in%20the%20data%20into%20intervals%2C%20and%20calculated%20min%20and%20max%20values%20for%20the%20**years_distant**%20betwen%20year%20of%20release%20and%20year%20the%20work%20is%20set.%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20The%20data%20does%20include%20some%20non-sequential%20spans%2C%20but%20for%20simplicity%20in%20this%20case%20we%20treat%20it%20as%20the%20range%20covering%20of%20the%20earliest%20and%20latest%20dates.%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20sf_time_multiyear_undate.select(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22title%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22creator%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22released%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22year_set%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years_distant%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22multiyears%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22undate_interval%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_earliest%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22interval_latest%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years_distant_min%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years_distant_max%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22duration%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22years%20distant%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%20(sf_time_multiyear_undate%2C)%0A%0A%0A%40app.cell%0Adef%20_(alt%2C%20sf_time_multiyear_undate)%3A%0A%20%20%20%20base_chart%20%3D%20alt.Chart(sf_time_multiyear_undate)%0A%0A%20%20%20%20year_range_chart%20%3D%20base_chart.mark_bar(opacity%3D0.8%2C%20color%3D%22%237570b3%22).encode(%0A%20%20%20%20%20%20%20%20x%3Dalt.X(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22interval_earliest%22%2C%20title%3D%22Years%20work%20set%20(multiyear%20works)%22%0A%20%20%20%20%20%20%20%20).scale(type%3D%22log%22)%2C%0A%20%20%20%20%20%20%20%20x2%3D%22interval_latest%22%2C%0A%20%20%20%20%20%20%20%20y%3Dalt.Y(%22released%22%2C%20title%3D%22Year%20Released%22).axis(format%3D%22r%22)%2C%0A%20%20%20%20%20%20%20%20tooltip%3D%5B%22title%22%2C%20%22creator%22%2C%20%22multiyears%22%5D%2C%0A%20%20%20%20)%0A%20%20%20%20year_midpoint_chart%20%3D%20base_chart.mark_point(%0A%20%20%20%20%20%20%20%20color%3D%22%2317becf%22%2C%20opacity%3D0.7%0A%20%20%20%20).encode(x%3Dalt.X(%22year_set%22).scale(type%3D%22log%22)%2C%20y%3D%22released%22)%0A%0A%20%20%20%20%23%20(year_range_chart%20%2B%20year_midpoint_chart).interactive()%0A%20%20%20%20return%20year_midpoint_chart%2C%20year_range_chart%0A%0A%0A%40app.cell%0Adef%20_(%0A%20%20%20%20alt%2C%0A%20%20%20%20mo%2C%0A%20%20%20%20pl%2C%0A%20%20%20%20sf_time_multiyear_undate%2C%0A%20%20%20%20year_midpoint_chart%2C%0A%20%20%20%20year_range_chart%2C%0A)%3A%0A%20%20%20%20%23%20now%20graph%20years%20distant%0A%20%20%20%20base_distance_chart%20%3D%20alt.Chart(%0A%20%20%20%20%20%20%20%20sf_time_multiyear_undate.filter(pl.col(%22undate_interval%22).is_not_null())%0A%20%20%20%20)%0A%0A%20%20%20%20%23%20common%20configuration%20for%20x-axis%0A%20%20%20%20x_axis_released%20%3D%20(%0A%20%20%20%20%20%20%20%20alt.X(%22released%22%2C%20title%3D%22Year%20Released%22).axis(format%3D%22r%22).scale(nice%3DFalse)%0A%20%20%20%20)%0A%0A%20%20%20%20years_distant_range_chart%20%3D%20base_distance_chart.mark_bar(%0A%20%20%20%20%20%20%20%20color%3D%22%237570b3%22%0A%20%20%20%20).encode(%0A%20%20%20%20%20%20%20%20y%3Dalt.Y(%22years_distant_min%22%2C%20title%3D%22Years%20in%20the%20future%22)%2C%0A%20%20%20%20%20%20%20%20y2%3D%22years_distant_max%22%2C%0A%20%20%20%20%20%20%20%20x%3Dx_axis_released%2C%0A%20%20%20%20%20%20%20%20tooltip%3D%5B%22title%22%2C%20%22creator%22%5D%2C%0A%20%20%20%20)%0A%0A%20%20%20%20%23%20tableau%20orange%20%23f58518%0A%0A%20%20%20%20years_distant_midpoint_chart%20%3D%20base_distance_chart.mark_circle(%0A%20%20%20%20%20%20%20%20color%3D%22%2317becf%22%2C%20opacity%3D0.3%0A%20%20%20%20).encode(%0A%20%20%20%20%20%20%20%20y%3Dalt.Y(%22years_distant%22)%2C%0A%20%20%20%20%20%20%20%20x%3Dx_axis_released%2C%0A%20%20%20%20)%0A%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22This%20chart%20shows%20the%20range%20of%20years%20that%20works%20are%20set%2C%20organized%20by%20year%20of%20release.%20Because%20some%20works%20are%20so%20far%20in%20the%20future%2C%20this%20requires%20a%20logarithmic%20scale.%20%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(year_range_chart%20%2B%20year_midpoint_chart).interactive()%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22We%20can%20try%20to%20chart%20the%20full-scale%20of%20the%20difference%20in%20year%20of%20release%20and%20year%20a%20work%20is%20set%2C%20but%20this%20chart%20is%20dominated%20by%20a%20few%20outliers%20with%20very%20long%20time%20scale.%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20years_distant_range_chart%20%2B%20years_distant_midpoint_chart%0A%20%20%20%20%20%20%20%20%20%20%20%20).interactive()%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%20base_distance_chart%2C%20x_axis_released%0A%0A%0A%40app.cell%0Adef%20_(alt%2C%20base_distance_chart%2C%20mo%2C%20x_axis_released)%3A%0A%20%20%20%20%23%20customize%20opacity%20based%20on%20the%20duration%0A%20%20%20%20%23%20wider%20span%20%3D%3D%20less%20opacity%0A%20%20%20%20opacity_condition%20%3D%20%7B%0A%20%20%20%20%20%20%20%20%22condition%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%7B%22test%22%3A%20%22datum.duration%20%3C%3D%20100%22%2C%20%22value%22%3A%201.0%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7B%22test%22%3A%20%22datum.duration%20%3C%3D%20500%22%2C%20%22value%22%3A%200.9%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7B%22test%22%3A%20%22datum.duration%20%3C%3D%201000%22%2C%20%22value%22%3A%200.7%7D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%7B%22test%22%3A%20%22datum.duration%20%3C%3D%2010000%22%2C%20%22value%22%3A%200.5%7D%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%22value%22%3A%200.4%2C%0A%20%20%20%20%7D%0A%0A%20%20%20%20years_distant_1k_chart%20%3D%20base_distance_chart.mark_bar(%0A%20%20%20%20%20%20%20%20clip%3DTrue%2C%20color%3D%22%237570b3%22%0A%20%20%20%20).encode(%0A%20%20%20%20%20%20%20%20y%3Dalt.Y(%22years_distant_min%22%2C%20title%3D%22Years%20in%20the%20future%22).scale(%0A%20%20%20%20%20%20%20%20%20%20%20%20domain%3D(-50%2C%201000)%0A%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20y2%3D%22years_distant_max%22%2C%0A%20%20%20%20%20%20%20%20x%3Dx_axis_released%2C%0A%20%20%20%20%20%20%20%20tooltip%3D%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22title%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22creator%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22multiyears%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22years%20distant%22%2C%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20opacity%3Dopacity_condition%2C%0A%20%20%20%20)%0A%0A%20%20%20%20years_distant_1k_midpoint_chart%20%3D%20base_distance_chart.mark_circle(%0A%20%20%20%20%20%20%20%20color%3D%22%2317becf%22%2C%20opacity%3D0.3%2C%20clip%3DTrue%0A%20%20%20%20).encode(%0A%20%20%20%20%20%20%20%20y%3Dalt.Y(%22years_distant%22)%2C%0A%20%20%20%20%20%20%20%20x%3Dx_axis_released%2C%0A%20%20%20%20)%0A%0A%20%20%20%20%23%20chart%20works%20by%20year%20released%0A%20%20%20%20%23%20tableau%20red%20%23e45756%0A%20%20%20%20works_by_year_released%20%3D%20(%0A%20%20%20%20%20%20%20%20base_distance_chart.mark_line(interpolate%3D%22monotone%22%2C%20color%3D%22%23d62728%22)%0A%20%20%20%20%20%20%20%20.encode(%0A%20%20%20%20%20%20%20%20%20%20%20%20y%3Dalt.Y(%22count(title)%22%2C%20title%3D%22%23%20Works%22)%2C%20x%3Dx_axis_released.axis(None)%0A%20%20%20%20%20%20%20%20)%20%20%23%20don't%20display%20x-axis%2C%20since%20will%20be%20combined%0A%20%20%20%20%20%20%20%20.properties(height%3D100%2C%20width%3D1000)%0A%20%20%20%20)%0A%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22This%20chart%20shows%20how%20many%20years%20in%20the%20future%20works%20are%20set%2C%20with%20a%20cap%20of%201000%20years.%20%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20The%20time%20difference%20for%20multiyear%20intervals%20is%20shown%20in%20purple%2C%20with%20decreasing%20opacity%20as%20the%20duration%20of%20the%20time%20gets%20larger.%20%20The%20midpoint%20years%20distance%20chosen%20by%20the%20dataset%20authors%20is%20graphed%20as%20a%20point%20along%20the%20bar%20for%20the%20time%20range.%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20The%20%20upper%20line%20chart%20shows%20the%20number%20of%20works%20per%20year%20in%20the%20dataset%2C%20for%20context.%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20works_by_year_released%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%26%20(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20years_distant_1k_chart%20%2B%20years_distant_1k_midpoint_chart%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20).properties(width%3D1000)%0A%20%20%20%20%20%20%20%20%20%20%20%20).interactive()%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(%0A%20%20%20%20%20%20%20%20r%22%22%22%0A%20%20%20%20%23%23%20Conclusion%0A%0A%20%20%20%20%60undate%60%20is%20still%20in%20beta%2C%20building%20on%20work%20from%20%5BShakespeare%20and%20Company%20Project%5D(https%3A%2F%2Fshakespeareandco.princeton.edu%2F)%2C%20%5BPrinceton%20Geniza%20Project%5D(https%3A%2F%2Fgeniza.princeton.edu%2F)%2C%20and%20%5BIslamic%20Scientific%20Manuscripts%20Initiative%5D(https%3A%2F%2Fismi.mpiwg-berlin.mpg.de%2F).%0A%0A%20%20%20%20We're%20still%20actively%20developing%20the%20library%20and%20expanding%20and%20improving%20functionality%20as%20we%20work%20towards%20a%201.0%20release%2C%20but%20as%20you%20can%20see%20from%20this%20demo%2C%20the%20library%20is%20already%20quite%20useful.%20We%20would%20love%20to%20have%20new%20contributors%20join%20the%20project%20and%20add%20new%20datasets%2C%20share%20use%20cases%2C%20and%20maybe%20even%20contribute%20to%20code%2C%20documentation%2C%20and%20examples.%0A%20%20%20%20%22%22%22%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20from%20collections%20import%20namedtuple%0A%0A%20%20%20%20%23%20use%20icons%20to%20help%20visually%20distinguish%20types%20of%20resources%0A%20%20%20%20Icons%20%3D%20namedtuple(%22Icons%22%2C%20%5B%22article%22%2C%20%22dataset%22%2C%20%22website%22%2C%20%22code%22%5D)%0A%20%20%20%20my_icons%20%3D%20Icons(%0A%20%20%20%20%20%20%20%20article%3Dmo.icon(%22material-symbols%3Aarticle-outline%22)%2C%0A%20%20%20%20%20%20%20%20dataset%3Dmo.icon(%22material-symbols%3Adataset-outline%22)%2C%0A%20%20%20%20%20%20%20%20website%3Dmo.icon(%22material-symbols%3Aweb%22)%2C%0A%20%20%20%20%20%20%20%20code%3Dmo.icon(%22material-symbols%3Acode-blocks%22)%2C%0A%20%20%20%20)%0A%0A%20%20%20%20mo.vstack(%0A%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(%22%23%23%20Resources%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.hstack(%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%7Bmy_icons.article%7D%20article%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%7Bmy_icons.dataset%7D%20dataset%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%7Bmy_icons.code%7D%20software%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%7Bmy_icons.website%7D%20website%22)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20gap%3D1%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20justify%3D%22start%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20justify%3D%22space-between%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20align%3D%22center%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20widths%3D%5B2%2C%201%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20)%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20mo.md(f%22%22%22%0A%20%20%20%20-%20_Shakespeare%20and%20Company%20Project_.%202020.%20Publisher%3A%20Center%20for%20Digital%20Humanities%2C%20Princeton%20University.%20https%3A%2F%2Fshakespeareandco.princeton.edu%2F.%20%7Bmy_icons.website%7D%0A%20%20%20%20-%20_Princeton%20Geniza%20Project_.%202022.%20Publisher%3A%20Center%20for%20Digital%20Humanities%2C%20Princeton%20University.%20https%3A%2F%2Fgeniza.princeton.edu%2F.%20%7Bmy_icons.website%7D%0A%20%20%20%20-%20Library%20of%20Congress.%202019.%20Extended%20Date%20Time%20Format%20(EDTF)%20Specification.%20Library%20of%20Congress%2C%20February.%20Accessed%20March%2030%2C%202025.%20https%3A%2F%2Fwww.loc.gov%2Fstandards%2Fdatetime%2F.%20%7Bmy_icons.article%7D%0A%20%20%20%20-%20Koeser%2C%20Rebecca%20Sutton%2C%20Julia%20Damerow%2C%20Robert%20Casties%2C%20and%20Cole%20Crawford.%20%E2%80%9CUndate%3A%20Humanistic%20Dates%20for%20Computation.%E2%80%9D%20_Computational%20Humanities%20Research_%2C%202025%2C%201%E2%80%9310.%20https%3A%2F%2Fdoi.org%2F10.1017%2Fchr.2025.10006.%20%7Bmy_icons.article%7D%0A%20%20%20%20-%20Koeser%2C%20Rebecca%20Sutton%2C%20Cole%20Crawford%2C%20Julia%20Damerow%2C%20Malte%20Vogl%2C%20and%20Robert%20Casties.%20%E2%80%9CUndate%20Python%20Library%E2%80%9D.%20Zenodo%2C%20July%2022%2C%202025.%20https%3A%2F%2Fdoi.org%2F10.5281%2Fzenodo.16328670.%20%7Bmy_icons.code%7D%0A%20%20%20%20-%20Koeser%2C%20Rebecca%20Sutton%2C%20and%20Zoe%20LeBlanc.%202024.%20Missing%20Data%2C%20Speculative%20Reading.%20_Journal%20of%20Cultural%20Analytics_%209%2C%20no.%202%20(May).%20https%3A%2F%2Fdoi.org%2F10.22148%2F001c.116926%20%7Bmy_icons.article%7D%0A%20%20%20%20-%20Koeser%2C%20Rebecca%20Sutton%20%26%20Kotin%2C%20Joshua.%20(2025).%20Shakespeare%20and%20Company%20Project%20Datasets%20%5BData%20set%5D.%20Version%202.%20Princeton%20University.%20https%3A%2F%2Fdoi.org%2F10.34770%2Fkf6c-b079%20%7Bmy_icons.dataset%7D%0A%20%20%20%20-%20Kotin%2C%20Joshua%20and%20Rebecca%20Sutton%20Koeser.%202022.%20Shakespeare%20and%20Company%20Project%20Data%20Sets.%20_Journal%20of%20Cultural%20Analytics_%207%2C%20no.%201%20(February).%20https%3A%2F%2Fdoi.org%2F10.22148%2F001c.32551%20%7Bmy_icons.article%7D%0A%20%20%20%20-%20Rustow%2C%20Marina%2C%20Rebecca%20Sutton%20Koeser%2C%20Rachel%20Richman%2C%20Ksenia%20Ryzhova%2C%20Amel%20Bensalim%2C%20and%20Abdellatif%20Mohamed.%20%E2%80%9CPrinceton%20Geniza%20Project%20dataset%E2%80%9D.%20Zenodo%2C%20July%208%2C%202025.%20https%3A%2F%2Fdoi.org%2F10.5281%2Fzenodo.15839056%20%7Bmy_icons.dataset%7D%0A%20%20%20%20-%20Wythoff%2C%20Grant%2C%20and%20Theodore%20Leane.%202025.%20%E2%80%9CTime%20Horizons%20of%20Futuristic%20Fiction.%E2%80%9D%20Edited%20by%20Alexander%20Manshel%2C%20J.D.%20Porter%2C%20and%20Melanie%20Walsh.%20Post45%20Data%20Collective%2C%20June.%20https%3A%2F%2Fdoi.org%2F10.18737%2F552626.%20%7Bmy_icons.dataset%7D%22%22%22)%2C%0A%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A