Merge pull request #412 from yvvijay121/initial&continuouseligibility

Creating More Detailed TANF Eligibility Variables

Author: MaxGhenis

CHANGELOG.md

@@ -4,10 +4,15 @@
 
 * First prototype version with a standard deduction variable
 
-## 0.3.0
+### 0.3.0
 
 * Add Lifeline benefit
 
-## 0.3.1
+#### 0.3.1
 
 * Add automated tests
+
+### 0.4.0
+
+* Broke down TANF eligibility into demographic and financial variables, with financial separated by current enrollment in program
+* Specified demographic TANF eligibility per IL rules

Makefile

@@ -12,3 +12,4 @@ documentation:
 	jb build docs/book
 build:
 	python setup.py sdist bdist_wheel
+

openfisca_us/tests/policy/baseline/hhs/tanf/is_person_demographic_tanf_eligible.yaml

@@ -0,0 +1,33 @@
+- name: "Default person is 18 and out of school, therefore ineligible for TANF"
+  period: 2022
+  output:
+    is_person_demographic_tanf_eligible: false
+
+- name: "Is eligible for TANF due to children under 18"
+  period: 2022
+  input:
+    age: 17
+  output:
+    is_person_demographic_tanf_eligible: true
+
+- name: "18-year-old out of school is not eligible for TANF"
+  period: 2022
+  input:
+    age: 18
+  output:
+    is_person_demographic_tanf_eligible: false
+
+- name: "Is eligible for TANF due to pregnancy"
+  period: 2022
+  input:
+    is_pregnant: true
+  output:
+    is_person_demographic_tanf_eligible: true
+
+- name: "Is eligible for TANF due to being an 18-year-old in school"
+  period: 2022
+  input:
+    age: 18
+    is_in_school: true
+  output:
+    is_person_demographic_tanf_eligible: true

openfisca_us/tests/policy/baseline/hhs/tanf/is_tanf_eligible.yaml

@@ -1,97 +1,76 @@
-- name: "Is eligible for TANF due to children under 18"
+- name: "Default SPM unit is ineligible because economic eligibility defaults to false"
   period: 2022
-  absolute_error_margin: 0.01
-  input:
-    age: 17
-  output:
-    is_tanf_eligible: true
-
-- name: "Is not eligible for TANF"
-  period: 2022
-  absolute_error_margin: 0.01
-  input:
-    age: 18
   output:
     is_tanf_eligible: false
 
-- name: "Is eligible for TANF due to pregnancy"
-  period: 2022
-  absolute_error_margin: 0.01
-  input:
-    is_pregnant: true
-  output:
-    is_tanf_eligible: true
-
-- name: "Is eligible for TANF due to being an 18-year-old in school"
-  period: 2022
-  absolute_error_margin: 0.01
-  input:
-    age: 18
-    is_in_school: true
-  output:
-    is_tanf_eligible: true
-
-- name: "Is eligible for TANF due to family with ineligible adult and eligible pregnant person"
+- name: "TANF: Unit test: two people, continued application, is eligible economically and demographically"
   period: 2022
-  absolute_error_margin: 0.01
   input:
     people:
       person1:
-        age: 30
+        is_person_demographic_tanf_eligible: false
       person2:
-        age: 29
-        is_pregnant: true
+        is_person_demographic_tanf_eligible: true
     spm_units:
       spm_unit:
         members: [person1, person2]
-    households:
-      household:
-        state_code: IL
+        is_tanf_enrolled: true
+        continuous_tanf_eligibility: true
+        initial_tanf_eligibility: false
   output:
     is_tanf_eligible: true
 
-- name: "Is ineligible for TANF due to family with two ineligible adults"
+- name: "TANF: Unit test: two people, continued application, is not eligible demographically"
   period: 2022
-  absolute_error_margin: 0.01
   input:
     people:
       person1:
-        age: 30
+        is_person_demographic_tanf_eligible: false
       person2:
-        age: 56
+        is_person_demographic_tanf_eligible: false
     spm_units:
       spm_unit:
         members: [person1, person2]
+        is_tanf_enrolled: true
+        continuous_tanf_eligibility: false
+        initial_tanf_eligibility: false
   output:
     is_tanf_eligible: false
 
-- name: "Is eligible for TANF due to family with ineligible adult and eligible child"
+- name: "TANF: Unit test: three people, initial application, is not eligible economically"
   period: 2022
-  absolute_error_margin: 0.01
   input:
     people:
-      father:
-        age: 38
-      child:
-        age: 11
+      person1:
+        is_person_demographic_tanf_eligible: false
+      person2:
+        is_person_demographic_tanf_eligible: true
+      person3:
+        is_person_demographic_tanf_eligible: false
     spm_units:
       spm_unit:
-        members: [father, child]
+        members: [person1, person2, person3]
+        is_tanf_enrolled: false
+        continuous_tanf_eligibility: false
+        initial_tanf_eligibility: false
   output:
-    is_tanf_eligible: true
+    is_tanf_eligible: false
 
-- name: "Is eligible for TANF due to family with eligible child and eligible pregnant person"
+- name: "TANF: Unit test: three people, initial application, is not eligible economically or demographically"
   period: 2022
-  absolute_error_margin: 0.01
   input:
     people:
-      mother:
-        age: 30
-        is_pregnant: true
-      child:
-        age: 7
+      person1:
+        is_person_demographic_tanf_eligible: false
+      person2:
+        is_person_demographic_tanf_eligible: false
+      person3:
+        is_person_demographic_tanf_eligible: false
     spm_units:
       spm_unit:
-        members: [mother, child]
+        members: [person1, person2, person3]
+        is_tanf_enrolled: false
+        continuous_tanf_eligibility: false
+        initial_tanf_eligibility: false
   output:
-    is_tanf_eligible: true
+    is_tanf_eligible: false

openfisca_us/variables/hhs/tanf.py

@@ -12,7 +12,7 @@ class tanf(Variable):
     documentation = (
         "Amount of Temporary Assistance for Needy Families benefit received."
     )
-    unit = "currency-USD"
+    unit = USD
 
     def formula(spm_unit, period, parameters):
         # Obtain eligibility.
@@ -22,6 +22,45 @@ def formula(spm_unit, period, parameters):
         return where(eligible, amount_if_eligible, 0)
 
 
+class continuous_tanf_eligibility(Variable):
+    value_type = bool
+    entity = SPMUnit
+    definition_period = YEAR
+    label = "Continued Economic Eligibility for TANF"
+    documentation = "Whether the familiy meets the economic requirements for the Temporary Assistance for Needy Families program after being approved."
+
+
+class initial_tanf_eligibility(Variable):
+    value_type = bool
+    entity = SPMUnit
+    definition_period = YEAR
+    label = "Initial Economic Eligibility for TANF"
+    documentation = "Whether the familiy meets the economic requirements for the Temporary Assistance for Needy Families program on application."
+
+
+class is_person_demographic_tanf_eligible(Variable):
+    value_type = bool
+    entity = Person
+    definition_period = YEAR
+    label = "Person-level eligiblity for TANF based on age, pregnancy, etc."
+    documentation = "Whether a person in a family applying for the Temporary Assistance for Needy Families program meets demographic requirements."
+
+    def formula(person, period, parameters):
+        child_0_17 = person("is_child", period)
+        is_18 = person("age", period) == 18
+        school_enrolled_18_year_old = person("is_in_school", period) & is_18
+        pregnant = person("is_pregnant", period)
+        return child_0_17 | school_enrolled_18_year_old | pregnant
+
+
+class is_tanf_enrolled(Variable):
+    value_type = bool
+    entity = SPMUnit
+    definition_period = YEAR
+    label = "Current Enrollement in TANF"
+    documentation = "Whether the familiy is currently enrolled in the Temporary Assistance for Needy Families program."
+
+
 class is_tanf_eligible(Variable):
     value_type = bool
     entity = SPMUnit
@@ -30,15 +69,15 @@ class is_tanf_eligible(Variable):
     documentation = "Whether the family is eligible for Temporary Assistance for Needy Families benefit."
 
     def formula(spm_unit, period, parameters):
-        children_0_17 = spm_unit.sum(spm_unit.members("is_child", period))
-        school_enrolled_18_year_olds = spm_unit.sum(
-            (spm_unit.members("is_in_school", period))
-            & (spm_unit.members("age", period) == 18)
+        demographic_eligible = spm_unit.any(
+            spm_unit.members("is_person_demographic_tanf_eligible", period)
+        )
+        economic_eligible = where(
+            spm_unit("is_tanf_enrolled", period),
+            spm_unit("continuous_tanf_eligibility", period),
+            spm_unit("initial_tanf_eligibility", period),
         )
-        pregnant_people = spm_unit.sum(spm_unit.members("is_pregnant", period))
-        return (
-            children_0_17 + school_enrolled_18_year_olds + pregnant_people
-        ) > 0
+        return demographic_eligible & economic_eligible
 
 
 # Quick fix, should be fixed by resolving https://github.com/openfisca/openfisca-core/issues/1085
@@ -57,7 +96,7 @@ class tanf_max_amount(Variable):
     definition_period = YEAR
     label = "TANF maximum benefit"
     documentation = "The maximum benefit amount a family could receive from Temporary Assistance for Needy Families given their state and family size."
-    unit = "currency-USD"
+    unit = USD
 
     def formula(spm_unit, period, parameters):
         family_size = spm_unit.nb_persons().astype(str)
@@ -72,7 +111,7 @@ class tanf_countable_income(Variable):
     definition_period = YEAR
     label = "TANF countable income"
     documentation = "Countable income for calculating Temporary Assistance for Needy Families benefit."
-    unit = "currency-USD"
+    unit = USD
 
     def formula(spm_unit, period, parameters):
         tanf_gross_income = spm_unit("tanf_total_gross_income", period)
@@ -89,7 +128,7 @@ class tanf_total_gross_income(Variable):
     definition_period = YEAR
     label = "TANF gross income"
     documentation = "Gross income for calculating Temporary Assistance for Needy Families benefit. Includes both gross earned and unearned income."
-    unit = "currency-USD"
+    unit = USD
     reference = "https://www.dhs.state.il.us/page.aspx?item=15814"
 
 
@@ -99,7 +138,7 @@ class tanf_amount_if_eligible(Variable):
     definition_period = YEAR
     label = "TANF amount if family is eligible"
     documentation = "How much a family would receive if they were eligible for Temporary Assistance for Needy Families benefit."
-    unit = "currency-USD"
+    unit = USD
 
     def formula(spm_unit, period, parameters):
         max_amount = spm_unit("tanf_max_amount", period)

setup.py

@@ -4,7 +4,7 @@
 
 setup(
     name="OpenFisca-US",
-    version="0.3.1",
+    version="0.4.0",
     author="Nikhil Woodruff",
     author_email="[email protected]",
     classifiers=[