📊 hfd: add indicators (#3610)

* 📊 hfd: add indicators

* add progression ratio

* fix type

* add breakdown by age

* fixes

etl/steps/data/garden/hmd/2024-11-19/hfd.meta.yml

@@ -13,12 +13,28 @@ definitions:
       <%- elif birth_order == '5p' %>
        fifth (or greater)
       <% endif %>
+    bo_1_m1: |-
+      <% if birth_order == '2' %>
+       second
+      <%- elif birth_order == '3' %>
+       third
+      <%- elif birth_order == '4' %>
+       fourth
+      <%- elif birth_order == '5p' %>
+       fifth (or greater)
+      <% endif %>
     title: |-
       <% if birth_order == 'total' %>
       << title >> - Total
       <%- else %>
       << title >> - Birth order: << birth_order >>
       <%- endif %>
+    title_age: |-
+      <% if birth_order == 'total' %>
+      << title >> - Mother age: << age >> - Birth order: Total
+      <%- else %>
+      << title >> - Mother age: << age >> - Birth order: << birth_order >>
+      <%- endif %>
   common:
     presentation:
       topic_tags:
@@ -284,3 +300,49 @@ tables:
         description_key:
           - Reflects variability in the timing of births up to age 40 within a cohort.
           - Helps to understand how concentrated or spread out early childbearing is within the cohort.
+
+      ppr:
+        title: |-
+          Cohort parity progression ratios - << birth_order | int >> to << (birth_order | int) + 1 >> birth
+        description_short: |-
+          <% if birth_order == '1' %>
+          Probability of giving birth to a first child.
+          <%- elif birth_order == '2' %>
+          Probability of giving birth to a second child, conditioned on having had a first child.
+          <%- elif birth_order == '3' %>
+          Probability of giving birth to a third child, conditioned on having had a second child.
+          <%- elif birth_order == '4' %>
+          Probability of giving birth to a fourth child, conditioned on having had a third child.
+          <% endif %>
+        unit: ""
+        description_key:
+          - Measures the likelihood that a woman with a given number of children will go on to have another child.
+          - It is useful for understanding family-building dynamics and changes in reproductive behavior over time.
+
+  period_ages:
+    variables:
+      asfr:
+        title: |-
+          <% set title = "Period fertility rates" %>
+          {definitions.others.title_age}
+        description_short: |-
+          Age-specific fertility rates for each calendar year, measured in completed years of age.
+        unit: "births per woman"
+        description_key:
+          - Represents fertility rates for each age group in a specific year.
+          - Useful for detailed analysis of fertility patterns by both age and year.
+          - Presented in the form of Lexis squares, which provide a snapshot of fertility behavior over time.
+
+  cohort_ages:
+    variables:
+      asfr:
+        title: |-
+          <% set title = "Cohort fertility rates" %>
+          {definitions.others.title_age}
+        unit: "births per woman"
+        description_short: |-
+          Age-specific fertility rates for women in a specific birth cohort, measured by their age in completed years.
+        description_key:
+          - Represents fertility rates for a specific cohort as they age.
+          - Useful for understanding how fertility behavior changes across different cohorts over time.
+          - Presented in the form of horizontal parallelograms, allowing for the tracking of cohort-specific fertility patterns.