-
Notifications
You must be signed in to change notification settings - Fork 62
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: Onboard Race and Economic Opportunity dataset (#236)
- Loading branch information
1 parent
ec93997
commit fe6c826
Showing
31 changed files
with
3,136 additions
and
0 deletions.
There are no files selected for viewing
34 changes: 34 additions & 0 deletions
34
datasets/race_and_economic_opportunity/_images/run_csv_transform_kub/Dockerfile
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
# Copyright 2021 Google LLC | ||
# | ||
# Licensed under the Apache License, Version 2.0 (the "License"); | ||
# you may not use this file except in compliance with the License. | ||
# You may obtain a copy of the License at | ||
# | ||
# http://www.apache.org/licenses/LICENSE-2.0 | ||
# | ||
# Unless required by applicable law or agreed to in writing, software | ||
# distributed under the License is distributed on an "AS IS" BASIS, | ||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
# See the License for the specific language governing permissions and | ||
FROM python:3.8 | ||
|
||
# Allow statements and log messages to appear in Cloud logs | ||
ENV PYTHONUNBUFFERED True | ||
|
||
# Copy the requirements file into the image | ||
COPY requirements.txt ./ | ||
|
||
# Install the packages specified in the requirements file | ||
RUN python3 -m pip install --no-cache-dir -r requirements.txt | ||
|
||
# The WORKDIR instruction sets the working directory for any RUN, CMD, | ||
# ENTRYPOINT, COPY and ADD instructions that follow it in the Dockerfile. | ||
# If the WORKDIR doesn’t exist, it will be created even if it’s not used in | ||
# any subsequent Dockerfile instruction | ||
WORKDIR /custom | ||
|
||
# Copy the specific data processing script/s in the image under /custom/* | ||
COPY ./csv_transform.py . | ||
|
||
# Command to run the data processing script when the container is run | ||
CMD ["python3", "csv_transform.py"] |
108 changes: 108 additions & 0 deletions
108
datasets/race_and_economic_opportunity/_images/run_csv_transform_kub/csv_transform.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,108 @@ | ||
# Copyright 2021 Google LLC | ||
# | ||
# Licensed under the Apache License, Version 2.0 (the "License"); | ||
# you may not use this file except in compliance with the License. | ||
# You may obtain a copy of the License at | ||
# | ||
# http://www.apache.org/licenses/LICENSE-2.0 | ||
# | ||
# Unless required by applicable law or agreed to in writing, software | ||
# distributed under the License is distributed on an "AS IS" BASIS, | ||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
# See the License for the specific language governing permissions and | ||
# limitations under the License. | ||
|
||
import datetime | ||
import json | ||
import logging | ||
import os | ||
import pathlib | ||
import typing | ||
|
||
import pandas as pd | ||
import requests | ||
from google.cloud import storage | ||
|
||
|
||
def main( | ||
source_url: str, | ||
source_file: pathlib.Path, | ||
target_file: pathlib.Path, | ||
target_gcs_bucket: str, | ||
target_gcs_path: str, | ||
headers: typing.List[str], | ||
rename_mappings: dict, | ||
pipeline_name: str, | ||
) -> None: | ||
|
||
logging.info("Creating 'files' folder") | ||
pathlib.Path("./files").mkdir(parents=True, exist_ok=True) | ||
|
||
logging.info(f"Downloading file {source_url}") | ||
download_file(source_url, source_file) | ||
|
||
logging.info(f"Opening file {source_file}") | ||
df = pd.read_csv(str(source_file)) | ||
|
||
logging.info(f"Transformation Process Starting.. {source_file}") | ||
rename_headers(df, rename_mappings) | ||
df = df[headers] | ||
|
||
logging.info(f"Transformation Process complete .. {source_file}") | ||
logging.info(f"Saving to output file.. {target_file}") | ||
|
||
try: | ||
save_to_new_file(df, file_path=str(target_file)) | ||
except Exception as e: | ||
logging.error(f"Error saving output file: {e}.") | ||
|
||
logging.info( | ||
f"Uploading output file to.. gs://{target_gcs_bucket}/{target_gcs_path}" | ||
) | ||
upload_file_to_gcs(target_file, target_gcs_bucket, target_gcs_path) | ||
|
||
logging.info( | ||
f"Race and Economic Opportunity Data Tables {pipeline_name} process completed at " | ||
+ str(datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")) | ||
) | ||
|
||
|
||
def rename_headers(df: pd.DataFrame, rename_mappings: dict) -> None: | ||
df.rename(columns=rename_mappings, inplace=True) | ||
|
||
|
||
def save_to_new_file(df: pd.DataFrame, file_path: str) -> None: | ||
df.to_csv(file_path, float_format="%.0f", index=False) | ||
|
||
|
||
def download_file(source_url: str, source_file: pathlib.Path) -> None: | ||
logging.info(f"Downloading {source_url} into {source_file}") | ||
r = requests.get(source_url, stream=True) | ||
if r.status_code == 200: | ||
with open(source_file, "wb") as f: | ||
for chunk in r: | ||
f.write(chunk) | ||
else: | ||
logging.error(f"Couldn't download {source_url}: {r.text}") | ||
|
||
|
||
def upload_file_to_gcs(file_path: pathlib.Path, gcs_bucket: str, gcs_path: str) -> None: | ||
storage_client = storage.Client() | ||
bucket = storage_client.bucket(gcs_bucket) | ||
blob = bucket.blob(gcs_path) | ||
blob.upload_from_filename(file_path) | ||
|
||
|
||
if __name__ == "__main__": | ||
logging.getLogger().setLevel(logging.INFO) | ||
|
||
main( | ||
source_url=os.environ["SOURCE_URL"], | ||
source_file=pathlib.Path(os.environ["SOURCE_FILE"]).expanduser(), | ||
target_file=pathlib.Path(os.environ["TARGET_FILE"]).expanduser(), | ||
target_gcs_bucket=os.environ["TARGET_GCS_BUCKET"], | ||
target_gcs_path=os.environ["TARGET_GCS_PATH"], | ||
headers=json.loads(os.environ["CSV_HEADERS"]), | ||
rename_mappings=json.loads(os.environ["RENAME_MAPPINGS"]), | ||
pipeline_name=os.environ["PIPELINE_NAME"], | ||
) |
3 changes: 3 additions & 0 deletions
3
datasets/race_and_economic_opportunity/_images/run_csv_transform_kub/requirements.txt
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
requests | ||
google-cloud-storage | ||
pandas |
39 changes: 39 additions & 0 deletions
39
...rm/commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile" | ||
|
||
description = "Commuting Zone Income Rank Statistics by Race and Parent Income Percentile" | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_commuting_zone_income_rank_statistics_by_race_and_parent_income_percentile.id | ||
} |
39 changes: 39 additions & 0 deletions
39
...aform/crosswalk_between_parent_and_child_income_percentiles_and_dollar_values_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_crosswalk_between_parent_and_child_income_percentiles_and_dollar_values" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "crosswalk_between_parent_and_child_income_percentiles_and_dollar_values" | ||
|
||
description = "Crosswalk between Parent and Child Income Percentiles and Dollar Values" | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_crosswalk_between_parent_and_child_income_percentiles_and_dollar_values-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_crosswalk_between_parent_and_child_income_percentiles_and_dollar_values.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_crosswalk_between_parent_and_child_income_percentiles_and_dollar_values-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_crosswalk_between_parent_and_child_income_percentiles_and_dollar_values.id | ||
} |
39 changes: 39 additions & 0 deletions
39
...generational_transition_matrices_of_educational_attainment_by_race_and_gender_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender" | ||
|
||
description = "Intergenerational Transition Matrices of Educational Attainment by Race and Gender" | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_intergenerational_transition_matrices_of_educational_attainment_by_race_and_gender.id | ||
} |
39 changes: 39 additions & 0 deletions
39
...arent_income_transition_matrices_by_race_and_gender_for_children_with_mothers_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender" | ||
|
||
description = "National Child and Parent Income Transition Matrices by Race and Gender for Children with Mothers Born in the U.S." | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_natinational_child_and_parent_income_transition_matrices_by_race_and_gender_for_children_with_mothersonal_child_and_parent_income_transition_matrices_by_race_and_gender.id | ||
} |
39 changes: 39 additions & 0 deletions
39
...aform/national_child_and_parent_income_transition_matrices_by_race_and_gender_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_national_child_and_parent_income_transition_matrices_by_race_and_gender" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "national_child_and_parent_income_transition_matrices_by_race_and_gender" | ||
|
||
description = "National Child and Parent Income Transition Matrices by Race and Gender" | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_national_child_and_parent_income_transition_matrices_by_race_and_gender-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_national_child_and_parent_income_transition_matrices_by_race_and_gender.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_national_child_and_parent_income_transition_matrices_by_race_and_gender-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_national_child_and_parent_income_transition_matrices_by_race_and_gender.id | ||
} |
39 changes: 39 additions & 0 deletions
39
...tunity/_terraform/national_statistics_by_parent_income_percentile_gender_race_pipeline.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
/** | ||
* Copyright 2021 Google LLC | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
|
||
resource "google_bigquery_table" "race_and_economic_opportunity_national_statistics_by_parent_income_percentile_gender_race" { | ||
project = var.project_id | ||
dataset_id = "race_and_economic_opportunity" | ||
table_id = "national_statistics_by_parent_income_percentile_gender_race" | ||
|
||
description = "National Statistics by Parent Income Percentile, Gender, and Race" | ||
|
||
|
||
|
||
|
||
depends_on = [ | ||
google_bigquery_dataset.race_and_economic_opportunity | ||
] | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_national_statistics_by_parent_income_percentile_gender_race-table_id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_national_statistics_by_parent_income_percentile_gender_race.table_id | ||
} | ||
|
||
output "bigquery_table-race_and_economic_opportunity_national_statistics_by_parent_income_percentile_gender_race-id" { | ||
value = google_bigquery_table.race_and_economic_opportunity_national_statistics_by_parent_income_percentile_gender_race.id | ||
} |
Oops, something went wrong.