Update PSL-catalog on 2023-10-26

PSLmodels · Oct 26, 2023 · 067c40c · 067c40c
1 parent 85db998
commit 067c40c
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/Catalog/catalog.json b/Catalog/catalog.json
@@ -616,7 +616,7 @@
         },
         "citation": {
             "source": "https://github.com/FRB-Atlanta-Advancing-Careers/policy-rules-database/blob/main/README.md",
-            "value": "<p>Ilin, Elias and Ellyn Terry. 2021. 'The Policy Rules Database.' Federal Reserve Bank of Atlanta. Available at www.frbatlanta.org/economic-mobility-and-resilience/advancing-careers-forlow-income-families/policy-rules-database.aspx. </p> <h5>How to Use This Repository?</h5> <p><strong>Step 1: Download the repository</strong></p> <p>Download and unzip this repository to your local machine. Make sure you have R and RStudio installed.</p> <p><strong>Step 2: Specify settings of the simulation - family characteristics and public benefits</strong></p> <p>Open TEST.yml file located in the <em>projects</em> folder. Adjust each input accordingly.</p> <p><strong>Step 3: Run the simulation</strong></p> <p>Open applyBenefitsCalculator.R and run the program.</p> <p><strong>Step 4: Explore the results</strong></p> <p>Results of the simulation are saved as a csv file in the <em>output</em> folder.</p> <p><strong>Step 5 (Optional): Modify and Explore</strong></p> <p>The PRD GitHub repository gives users flexibility in how to use the database. That includes:</p> <ul> <li> <p>Using PRD Excel files with the policy parameters located in <em>prd_parameters_excel</em> folder</p> </li> <li> <p>Modifying benefits_functions.R located in <em>functions</em> folder to produce policy simulations</p> </li> <li> <p>Applying PRD calculations to external datasets (CPS, ACS, SIPP etc) for microsimulation purposes </p> </li> </ul> <h5>Description of Each File Included in This Repository</h5> <p>This folder contains the following files:</p> <p><strong>1. \"PRD Technical Manual.pdf\"</strong></p> <p>This document provides detailed information on each public assistance program and tax credit included in the PRD. The document also describes the programming steps necessary to implement the calculations for each program in any programming language.</p> <p><strong>2. \"prd_parameters\" folder</strong></p> <p>Contains main Policy Rules Database parameters files in RData format. These files are then used by the PRD functions to produce the calculations</p> <p>The following files are located in this folder:</p> <ol> <li>benefit.parameters.RData - eligibility &amp; benefits parameters for each public assistance programs and tax credit included into the PRD</li> <li>expenses.RData - parameters from the supplementary cost-of-living database that can be used to retrieve information required to implement PRD calculations</li> <li>parameters.defaults.RData - default parameters used elsewhere in the PRD calculations (such as number of school days, number of summer days etc)</li> <li>tables.RData - supplemental tables and crosswalks (e.g. SMIs, FPLs, state FIPS to state name mapping etc)</li> </ol> <p><strong>3. \"prd_parameters_excel\" folder</strong></p> <p>Contains the PRD parameters in the alternative Excel format</p> <p><strong>4. \"functions\" folder</strong></p> <p>Contains main Policy Rules Database functions written in R programming language. These functions read-in parameters from (1) and determine eligibility/calculate the dollar value of benefits for each program. </p> <p>The following files are located in this folder:</p> <ol> <li>benefits_functions.R - functions that read-in PRD parameters and determine eligibility/calculate value of benefits for each public assistance program and tax credit contained in the PRD</li> <li>expense_functions.R - functions that assign default expenses using Cost of Living Database</li> <li>BenefitsCalculator_functions.R - higher-level program that aggregates smaller functions into blocks (Expenses, Childcare, Healthcare, Food and Housing, Taxes and Tax Credits, Other Benefits) </li> </ol> <p><strong>5. applyBenefitsCalculator.R</strong></p> <p>High-level program that runs the Benfits Calculator in its entirety</p> <p><strong>6. libraries.R</strong></p> <p>Packages and libraries required to run example codes below</p> <p><strong>7. \"projects\" folder</strong></p> <p>YML files that are used to provide the specification for the PRD (i.e. specify the family demographics and benefits composition to run through the PRD). TEST.yml is then read-in by the applyBenefitsCalculator.R program and produces calculations</p> <p>To test changes/run PRD you can do the following:</p> <ol> <li>In projects folder, copy TEST.yml to YOUR_NAME.yml</li> <li>Open YOUR_NAME.yml file in any text editor; adust specifications as needed</li> <li>Open applyBenefitsCalculator.R; specify PROJECT object as YOUR_NAME</li> <li>Run the program. Results are saved to the \"output\" folder as results_YOUR_NAME.csv file</li> </ol> <p><strong>8. \"output\" folder</strong></p> <p>applyBenefitsCalculator.R program saves the resulted output into this folder</p> <h5>How to Use the Unit Test</h5> <p>A unit test is a way of testing the smallest piece of code that can be logically isolated in a system.</p> <p>These steps should be carried out only once:</p> <ol> <li>Execute the following command library(here)</li> <li>Create an object with the path where the files are downloaded.</li> </ol> <p>proj_dir &lt;-\"/Users/.....\"</p> <ol> <li>Execute the following command setwd(proj_dir)</li> <li>Execute the following command set_here()</li> <li>Close your R session</li> </ol> <p>To test the functions:</p> <p>Check the Readme file inside the folder tests</p> <p><strong>9. Up to date Programs</strong></p> <p><img alt=\"image\" src=\"https://github.com/FRB-Atlanta-Advancing-Careers/policy-rules-database/assets/59230162/66d09e50-85df-4064-82d8-b73b56120048\" /></p>"
+            "value": "<p>Ilin, Elias and Ellyn Terry. 2021. 'The Policy Rules Database.' Federal Reserve Bank of Atlanta. Available at www.frbatlanta.org/economic-mobility-and-resilience/advancing-careers-forlow-income-families/policy-rules-database.aspx. </p> <h5>How to Use This Repository?</h5> <p><strong>Step 1: Download the repository</strong></p> <p>Download and unzip this repository to your local machine. Make sure you have R and RStudio installed.</p> <p><strong>Step 2: Specify settings of the simulation - family characteristics and public benefits</strong></p> <p>Open TEST.yml file located in the <em>projects</em> folder. Adjust each input accordingly.</p> <p><strong>Step 3: Run the simulation</strong></p> <p>Open applyBenefitsCalculator.R and run the program.</p> <p><strong>Step 4: Explore the results</strong></p> <p>Results of the simulation are saved as a csv file in the <em>output</em> folder.</p> <p><strong>Step 5 (Optional): Modify and Explore</strong></p> <p>The PRD GitHub repository gives users flexibility in how to use the database. That includes:</p> <ul> <li> <p>Using PRD Excel files with the policy parameters located in <em>prd_parameters_excel</em> folder</p> </li> <li> <p>Modifying benefits_functions.R located in <em>functions</em> folder to produce policy simulations</p> </li> <li> <p>Applying PRD calculations to external datasets (CPS, ACS, SIPP etc) for microsimulation purposes </p> </li> </ul> <h5>Description of Each File Included in This Repository</h5> <p>This folder contains the following files:</p> <p><strong>1. \"PRD Technical Manual.pdf\"</strong></p> <p>This document provides detailed information on each public assistance program and tax credit included in the PRD. The document also describes the programming steps necessary to implement the calculations for each program in any programming language.</p> <p><strong>2. \"prd_parameters\" folder</strong></p> <p>Contains main Policy Rules Database parameters files in RData format. These files are then used by the PRD functions to produce the calculations</p> <p>The following files are located in this folder:</p> <ol> <li>benefit.parameters.RData - eligibility &amp; benefits parameters for each public assistance programs and tax credit included into the PRD</li> <li>expenses.RData - parameters from the supplementary cost-of-living database that can be used to retrieve information required to implement PRD calculations</li> <li>parameters.defaults.RData - default parameters used elsewhere in the PRD calculations (such as number of school days, number of summer days etc)</li> <li>tables.RData - supplemental tables and crosswalks (e.g. SMIs, FPLs, state FIPS to state name mapping etc)</li> </ol> <p><strong>3. \"prd_parameters_excel\" folder</strong></p> <p>Contains the PRD parameters in the alternative Excel format</p> <p><strong>4. \"functions\" folder</strong></p> <p>Contains main Policy Rules Database functions written in R programming language. These functions read-in parameters from (1) and determine eligibility/calculate the dollar value of benefits for each program. </p> <p>The following files are located in this folder:</p> <ol> <li>benefits_functions.R - functions that read-in PRD parameters and determine eligibility/calculate value of benefits for each public assistance program and tax credit contained in the PRD</li> <li>expense_functions.R - functions that assign default expenses using Cost of Living Database</li> <li>BenefitsCalculator_functions.R - higher-level program that aggregates smaller functions into blocks (Expenses, Childcare, Healthcare, Food and Housing, Taxes and Tax Credits, Other Benefits) </li> </ol> <p><strong>5. applyBenefitsCalculator.R</strong></p> <p>High-level program that runs the Benfits Calculator in its entirety</p> <p><strong>6. libraries.R</strong></p> <p>Packages and libraries required to run example codes below</p> <p><strong>7. \"projects\" folder</strong></p> <p>YML files that are used to provide the specification for the PRD (i.e. specify the family demographics and benefits composition to run through the PRD). TEST.yml is then read-in by the applyBenefitsCalculator.R program and produces calculations</p> <p>To test changes/run PRD you can do the following:</p> <ol> <li>In projects folder, copy TEST.yml to YOUR_NAME.yml</li> <li>Open YOUR_NAME.yml file in any text editor; adust specifications as needed</li> <li>Open applyBenefitsCalculator.R; specify PROJECT object as YOUR_NAME</li> <li>Run the program. Results are saved to the \"output\" folder as results_YOUR_NAME.csv file</li> </ol> <p><strong>8. \"output\" folder</strong></p> <p>applyBenefitsCalculator.R program saves the resulted output into this folder</p> <h5>How to Use the Unit Test</h5> <p>A unit test is a way of testing the smallest piece of code that can be logically isolated in a system.</p> <p>These steps should be carried out only once:</p> <ol> <li>Execute the following command library(here)</li> <li>Create an object with the path where the files are downloaded.</li> </ol> <p>proj_dir &lt;-\"/Users/.....\"</p> <ol> <li>Execute the following command setwd(proj_dir)</li> <li>Execute the following command set_here()</li> <li>Close your R session</li> </ol> <p>To test the functions:</p> <p>Check the Readme file inside the folder tests</p>"
         },
         "license": {
             "source": "https://github.com/FRB-Atlanta-Advancing-Careers/policy-rules-database/blob/main/LICENSE",