medicaid_utils.topics.obgyn package¶

This subpackage has functions to represent commonly used covariates in OB/GYN studies

Submodules¶

medicaid_utils.topics.obgyn.cohort_indicators module¶

This module has functions used to flag cohort designations used in OB/GYN studies

medicaid_utils.topics.obgyn.cohort_indicators.flag_religious_npis(df_claims: DataFrame) → DataFrame[source]¶

Adds columns denoting categorization of NPIs in claims.

New columns:

catholic_npi: 0 or 1, 1 when claim contains an NPI that is a catholic hospital.
religious_npi: 0 or 1, 1 when claim contains an NPI that is a hospital with any religious affiliation.
secular_npi: : 0 or 1, 1 when claim contains an NPI that is a hospital with no reglious affiliation.
rural_npi: 0 or 1, when claim contains an NPI that is located in a rural location

Parameters:: df_claims (dd.DataFrame) – Claims dataframe
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.cohort_indicators.flag_transfers(df_claims: DataFrame) → DataFrame[source]¶

Adds indicator columns denoting whether the claim has a discharge status indicating a transfer. Currently only supports MAX files.

Parameters:: df_claims (dd.DataFrame) – IP or LT claim file
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.comorbities module¶

This module has functions used to flag presence of chronic conditions

medicaid_utils.topics.obgyn.comorbities.flag_chronic_conditions(cc_file: MAXCC) → DataFrame[source]¶

Adds boolean columns that denote presence of chronic conditions.

New Columns:

ckd_combined: any cardiac comorbidity
diab_combined: diabetes
hypten_combined: hypertension
ckd_combined: chronic kidney disease
depr_combined: depression
copd_combined: COPD
toba_combined: tobacco use

Parameters:: cc_file (max_cc.MAXCC)
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization module¶

medicaid_utils.topics.obgyn.hospitalization.calculate_conception(df_claims: DataFrame'>, <class 'dask.dataframe.dask_expr._collection.DataFrame'>)[source]¶

Estimates conception date based on type of delivery and delivery date.

Conception date is calculated as,

75 days before date of abortive claims
255 days before full term deliveries
230 days before pre-term deliveries
45 days before pre-natal claims

New columns:

conception_date: Date of conception.

Parameters:: df_claims (dd.DataFrame) – Claims dataframe that has indicator columns for type of deliveries, viz., hosp_abnormal_pregnancy, hosp_birth, hosp_preterm, and hosp_prenatal
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_abnormal_pregnancy(df_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Detects ectopic, molar, or abnormal pregnancy, spontaneous or induced abortion related hospitalization

New Column(s):

hosp_abnormal_pregnancy: integer column, 1 when claim denotes ectopic, molar, or abnormal pregnancy, spontaneous or induced abortion and 0 otherwise

Parameters:

df_claims (dd.DataFrame) – Claims dataframe
cms_format (str) – CMS format identifier, default is ‘MAX’

Return type:

dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_delivery(df_ip_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Detects normal and stillbirths related hospitalization in claims

New Column(s):

hosp_delivery: integer column, 1 when claim denotes live or still birth and 0 otherwise

Parameters:

df_ip_claims (dd.DataFrame) – IP claims dataframe
cms_format ({'MAX', TAF'}) – CMS file format.

Return type:

dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_delivery_mode(df_claims: DataFrame) → DataFrame[source]¶

Identifies mode of birth

New Column(s):

hosp_vag_dlvry: 0 or 1, 1 denotes vaginal delivery
hosp_csrn_dlvry: 0 or 1, 1 denotes caesarian delivery

Parameters:: df_claims (dd.DataFrame) – Claims dataframe
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_multiple_births(df_claims: DataFrame) → DataFrame[source]¶

Identifies multiple births

New Column(s):

hosp_multiple_births: 0 or 1, 1 when claim has codes indicating a multiple birt hdelivery

Parameters:: df_claims (dd.DataFrame) – Claims dataframe
Return type:: dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_preconception_care(df_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Adds flag columns denoting presence of codes indicating pre-conception care

New Columns:

hosp_preconception_care: 0 or 1, 1 when claim has codes indicating

pre-conception care - hosp_preconception_care_contraceptive_services: 0 or 1, 1 when claim has codes indicating contraceptive services related pre-conception care - hosp_preconception_care_pregnancy_testing_and_counseling: 0 or 1, 1 when claim has codes indicating pregnancy testing and counseling related pre-conception care - hosp_preconception_care_achieving_pregnancy: 0 or 1, 1 when claim has codes indicating achieving pregnancy related pre-conception care - hosp_preconception_care_basic_infertility_services: 0 or 1, 1 when claim has codes indicating basic infertility services related pre-conception care - hosp_preconception_care_preconception_health_services: 0 or 1, 1 when claim has codes indicating preconception health services related pre-conception care - hosp_preconception_care_std_services: 0 or 1, 1 when claim has codes indicating STD services related pre-conception care - hosp_preconception_care_related_preventive_health_services: 0 or 1, 1 when claim has codes indicating preventive health services related pre-conception care

Parameters:

df_claims (dd.DataFrame) – Claims dataframe
cms_format ({'MAX', TAF'}) – CMS file format.

Return type:

dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_prenatal(df_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Adds flag columns denoting presence of codes indicating pre-natal care

New Columns:

prenatal: 0 or 1, 1 when claim has codes indicating pre-natal care

Parameters:

df_claims (dd.DataFrame) – Claims dataframe
cms_format (str) – CMS format identifier, default is ‘MAX’

Return type:

dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_preterm(df_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Detects preterm birth related hospitalization in claims

New Column(s):

hosp_preterm: integer column, 1 when claim has codes denoting preterm birth and 0 otherwise

Parameters:

df_claims (dd.DataFrame) – Claims dataframe
cms_format (str) – CMS format identifier, default is ‘MAX’

Return type:

dd.DataFrame

medicaid_utils.topics.obgyn.hospitalization.flag_smm_events(df_ip_claims: DataFrame, cms_format: str = 'MAX') → DataFrame[source]¶

Adds flags for SMM events within 90 days of delivery

New Columns:

age_on_delivery (Age as on delivery admission date)
delivery_date (Delivery date)
smm_within_90_days_of_delivery (integer column, indicating an SSM

related hospitalization within 90 days of delivery) - smm_no_blood_within_90_days_of_delivery (integer column, indicating an SSM related hospitalization excluding those related to blood transfusion within 90 days of delivery)

Parameters:

df_ip_claims (dd.DataFrame) – IP claims dataframe
cms_format ({'MAX', TAF'}) – CMS file format.

Return type:

dd.DataFrame