From bb4ae40058676c89a2ae42feee4d0854e6492dbf Mon Sep 17 00:00:00 2001
From: ashwinmaran <amaran@wisc.edu>
Date: Tue, 7 Nov 2023 20:17:33 -0600
Subject: [PATCH] add lab-p10 and p10
---
lab-p10/README.md | 71 +
lab-p10/lab-p10.ipynb | 3499 +++++++++++++++++++++++++++++++
lab-p10/public_tests.py | 1056 ++++++++++
lab-p10/small_data.zip | Bin 0 -> 3469 bytes
p10/README.md | 68 +
p10/data.zip | Bin 0 -> 228004 bytes
p10/images/README.md | 7 +
p10/images/add_group_member.png | Bin 0 -> 160694 bytes
p10/images/gradescope.png | Bin 0 -> 61912 bytes
p10/images/summary.png | Bin 0 -> 20543 bytes
p10/p10.ipynb | 3421 ++++++++++++++++++++++++++++++
p10/public_tests.py | 878 ++++++++
p10/rubric.md | 151 ++
13 files changed, 9151 insertions(+)
create mode 100644 lab-p10/README.md
create mode 100644 lab-p10/lab-p10.ipynb
create mode 100644 lab-p10/public_tests.py
create mode 100644 lab-p10/small_data.zip
create mode 100644 p10/README.md
create mode 100644 p10/data.zip
create mode 100644 p10/images/README.md
create mode 100644 p10/images/add_group_member.png
create mode 100644 p10/images/gradescope.png
create mode 100644 p10/images/summary.png
create mode 100644 p10/p10.ipynb
create mode 100644 p10/public_tests.py
create mode 100644 p10/rubric.md
diff --git a/lab-p10/README.md b/lab-p10/README.md
new file mode 100644
index 0000000..dd115ef
--- /dev/null
+++ b/lab-p10/README.md
@@ -0,0 +1,71 @@
+# Lab-P10: Files and Namedtuples
+
+In this lab, you'll get practice with files and namedtuples, in preparation for P10.
+
+-----------------------------
+## Corrections/Clarifications
+
+
+**Find any issues?** Please report to us:
+
+- Ashwin Maran <amaran@wisc.edu>
+
+------------------------------
+## Learning Objectives
+
+In this lab, you will practice...
+* loading data in json files
+* loading data in csv files
+* using try/except to handle malformed data
+
+------------------------------
+
+## Note on Academic Misconduct
+
+You may do these lab exercises only with your project partner; you are not allowed to start
+working on Lab-P10 with one person, then do the project with a different partner. Now may be a
+good time to review [our course policies](https://cs220.cs.wisc.edu/f23/syllabus.html).
+
+**Important:** P10 and P11 are two parts of the same data analysis.
+You **cannot** switch project partners between these two projects.
+If you partner up with someone for P10, you have to sustain that partnership until end of P11.
+**You must acknowledge that you have read this to your lab TA**.
+
+------------------------------
+
+## Segment 1: Setup
+
+Create a `lab-p10` directory and download the following files into the `lab-p10` directory.
+
+* `small_data.zip`
+* `lab-p10.ipynb`
+* `public_tests.py`
+
+After downloading data.zip, make sure to extract it (using [Mac directions](http://osxdaily.com/2017/11/05/how-open-zip-file-mac/) or [Windows directions](https://support.microsoft.com/en-us/help/4028088/windows-zip-and-unzip-files)). After extracting, you need to make sure that the project files are stored in the following structure:
+
+```
++-- lab-p10.ipynb
++-- public_tests.py
++-- small_data
+| +-- .DS_Store
+| +-- .ipynb_checkpoints
+| +-- mapping_1.json
+| +-- mapping_2.json
+| +-- mapping_3.json
+| +-- planets_1.csv
+| +-- planets_2.csv
+| +-- planets_3.csv
+| +-- stars_1.csv
+| +-- stars_2.csv
+| +-- stars_3.csv
+```
+
+Make sure that the files inside `small_data.zip` are inside the `small_data` directory. You may delete `small_data.zip` after extracting these files from it.
+
+
+## Segment 2:
+For the remaining segments, detailed instructions are provided in `lab-p10.ipynb`. From the terminal, open a `jupyter notebook` session, open your `lab-p10.ipynb`, and follow the instructions in `lab-p10.ipynb`.
+
+## Project 10
+
+You can now get started with [p10](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/p10). **You may copy/paste any code created here in project P10**. Have fun!
diff --git a/lab-p10/lab-p10.ipynb b/lab-p10/lab-p10.ipynb
new file mode 100644
index 0000000..6c9ef8e
--- /dev/null
+++ b/lab-p10/lab-p10.ipynb
@@ -0,0 +1,3499 @@
+{
+ "cells": [
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "cfa86fb2",
+ "metadata": {
+ "cell_type": "code",
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "# import and initialize otter\n",
+ "import otter\n",
+ "grader = otter.Notebook(\"lab-p10.ipynb\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "894307b9",
+ "metadata": {
+ "editable": false,
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.315665Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.315665Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.598466Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.597454Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import public_tests"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c6057033",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "# Lab-P10: File Handling and Namedtuples"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2ce1ad9b",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Learning Objectives:\n",
+ "\n",
+ "In this lab, you will practice how to...\n",
+ "* use the `os` module to handle files,\n",
+ "* load data in json files,\n",
+ "* combine data from different files to create data structures,\n",
+ "* create named tuples,\n",
+ "* use `try/except` to handle malformed data."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "89f6242d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "<h2 style=\"color:red\">Warning (Note on Academic Misconduct):</h2>\n",
+ "\n",
+ "**IMPORTANT**: **P10 and P11 are two parts of the same data analysis.** You **cannot** switch project partners between these two projects. That is if you partner up with someone for P10, you have to sustain that partnership until end of P11. **You must acknowledge to the Lab TA to receive lab attendance credit.**\n",
+ "Be careful not to work with more than one partner. If you work with a partner on Lab-P10, you are **not** allowed to finish your project with a different partner.\n",
+ "You may either continue to work with the same partner, or work on P10 and P11 alone. Now may be a good time to review [our course policies](https://cs220.cs.wisc.edu/f23/syllabus.html).\n",
+ "\n",
+ "Under any circumstances, **no more than two students are allowed to work together on a project** as mentioned in the course policies. If your code is flagged by our code similarity detection tools, **both partners will be responsible** for sharing/copying the code, even if the code is shared/copied by one of the partners with/from other non-partner student(s). Note that each case of plagiarism will be reported to the Dean of Students with a zero grade on the project. **If you think that someone cannot be your project partner then don’t make that student your lab partner.**"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "831fd765",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Setup:\n",
+ "\n",
+ "Before proceeding much further, download `small_data.zip` and extract it to a directory on your\n",
+ "computer (using [Mac directions](http://osxdaily.com/2017/11/05/how-open-zip-file-mac/) or\n",
+ "[Windows directions](https://support.microsoft.com/en-us/help/4028088/windows-zip-and-unzip-files)).\n",
+ "\n",
+ "**Warning:** You need to make sure that the project files are stored in the following structure:\n",
+ "\n",
+ "```\n",
+ "+-- lab-p10.ipynb\n",
+ "+-- public_tests.py\n",
+ "+-- small_data\n",
+ "| +-- .DS_Store\n",
+ "| +-- .ipynb_checkpoints\n",
+ "| +-- mapping_1.json\n",
+ "| +-- mapping_2.json\n",
+ "| +-- mapping_3.json\n",
+ "| +-- planets_1.csv\n",
+ "| +-- planets_2.csv\n",
+ "| +-- planets_3.csv\n",
+ "| +-- stars_1.csv\n",
+ "| +-- stars_2.csv\n",
+ "| +-- stars_3.csv\n",
+ "```\n",
+ "\n",
+ "Make sure that the files inside `small_data.zip` are inside the `small_data` directory."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "77319e8a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Introduction:\n",
+ "\n",
+ "In P10 and P11, we will be studying stars and planets outside our Solar System using this dataset from the [NASA Exoplanet Archive](https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TblView/nph-tblView?app=ExoTbls&config=PSCompPars). We will use Python to ask some interesting questions about the laws of the universe and explore the habitability of other planets in our universe.\n",
+ "\n",
+ "In Lab-P10, you will work with a small subset of the full dataset. You can find these files inside `small_data.zip`. The full dataset used in P10 and P11 is stored in the same format, so you can then use this code to parse the dataset in P10 and P11."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "98060e97",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## The Data:\n",
+ "\n",
+ "You can open each of the files inside the `small_data` directory using Microsoft Excel or some other Spreadsheet viewing software to see how the data is stored. For example, these are the contents of the file `stars_1.csv`:\n",
+ "\n",
+ "|Star Name|Spectral Type|Stellar Effective Temperature [K]|Stellar Radius [Solar Radius]|Stellar Mass [Solar mass]|Stellar Luminosity [log(Solar)]|Stellar Surface Gravity [log10(cm/s**2)]|Stellar Age [Gyr]|\n",
+ "|----|-------------|---------------------------------|-----------------------------|-------------------------|-------------------------------|----------------------------------------|-----------------|\n",
+ "|55 Cnc|G8V|5172.00|0.94|0.91|-0.197|4.43|10.200|\n",
+ "|DMPP-1|F8V|6196.00|1.26|1.21|0.320|4.41|2.010|\n",
+ "|GJ 876|M2.5V|3271.00|0.30|0.32|-1.907|4.87|1.000|\n",
+ "\n",
+ "As you might have already guessed, this file contains data on a number of *stars* outside our solar system along with some important statistics about these stars. The columns here are as follows:\n",
+ "\n",
+ "- `Star Name`: The **name** given to the star by the *International Astronomical Union*,\n",
+ "- `Spectral Type`: The **Spectral Classification** of the star as per the *Morgan–Keenan (MK) system*,\n",
+ "- `Stellar Effective Temperature [K]`: The **temperature** of a *black body* (in units of Kelvin) that would emit the *observed radiation* of the star,\n",
+ "- `Stellar Radius [Solar Radius]`: The **radius** of the star (in units of the radius of the Sun),\n",
+ "- `Stellar Mass [Solar mass]`: The **mass** of the star (in units of the mass of the Sun),\n",
+ "- `Stellar Luminosity [log(Solar)]`: The *total* amount of **energy radiated** by the star **each second** (represented by the logarithm of the energy radiated by the Sun in each second),\n",
+ "- `Stellar Surface Gravity [log10(cm/s**2)]`: The **acceleration due to the gravity** of the Star at its *surface* (represented by the logarithm of the acceleration measured in centimeter per second squared),\n",
+ "- `Stellar Age [Gyr]`: The total **age** of the star (in units of Giga years, i.e., billions of years).\n",
+ "\n",
+ "The two other files `stars_2.csv`, and `stars_3.csv` also store similar data in the same format. At this stage, it is alright if you do not understand what these columns mean - they will be explained to you when they become necessary (in P10 and P11)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "7214a1ea",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "On the other hand, here are the contents of the file `planets_1.csv`:\n",
+ "\n",
+ "|Planet Name|Discovery Method|Discovery Year|Controversial Flag|Orbital Period [days]|Planet Radius [Earth Radius]|Planet Mass [Earth Mass]|Orbit Semi-Major Axis [au]|Eccentricity|Equilibrium Temperature [K]|Insolation Flux [Earth Flux]|\n",
+ "|-----------|----------------|--------------|------------------|---------------------|----------------------------|------------------------|---------------------------|------------|---------------------------|----------------------------|\n",
+ "|55 Cnc b|Radial Velocity|1996|0|14.65160000|13.900|263.97850|0.113400|0.000000|700||\n",
+ "|55 Cnc c|Radial Velocity|2004|0|44.39890000|8.510|54.47380|0.237300|0.030000|||\n",
+ "|DMPP-1 b|Radial Velocity|2019|0|18.57000000|5.290|24.27000|0.146200|0.083000|877||\n",
+ "|GJ 876 b|Radial Velocity|1998|0|61.11660000|13.300|723.22350|0.208317|0.032400|||\n",
+ "|GJ 876 c|Radial Velocity|2000|0|30.08810000|14.000|226.98460|0.129590|0.255910|||\n",
+ "\n",
+ "\n",
+ "This file contains data on a number of *planets* outside our solar system along with some important statistics about these planets. The columns here are as follows:\n",
+ "\n",
+ "- `Planet Name`: The **name** given to the planet by the *International Astronomical Union*,\n",
+ "- `Discovery Method`: The **method** by which the planet was *discovered*,\n",
+ "- `Discovery Year`: The **year** in which the planet was *discovered*,\n",
+ "- `Controversial Flag`: Indicates whether the status of the discovered object as a planet was **disputed** at the time of discovery, \n",
+ "- `Orbital Period [days]`: The amount of **time** (in units of days) it takes for the planet to **complete one orbit** around its star,\n",
+ "- `Planet Radius [Earth Radius]`: The **radius** of the planet (in units of the radius of the Earth),\n",
+ "- `Planet Mass [Earth Mass]`: The **mass** of the planet (in units of the mass of the Earth),\n",
+ "- `Orbit Semi-Major Axis [au]`: The **semi-major axis** of the planet's elliptical **orbit** around its host star (in units of Astronomical Units),\n",
+ "- `Eccentricity`: The **eccentricity** of the planet's orbit around its host star,\n",
+ "- `Equilibrium Temperature [K]`: The **temperature** of the planet (in units of Kelvin) if it were a *black body* heated only by its host star,\n",
+ "- `Insolation Flux [Earth Flux]`: The amount of **radiation** the planet received from its host star **per unit of area** (in units of the Insolation Flux of the Earth from the Sun).\n",
+ "\n",
+ "The two other files `planets_2.csv`, and `planets_3.csv` also store similar data in the same format."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8bb8727d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "Finally, if you take a look at `mapping_1.json` (you can open json files using any Text Editor), you will see that the file looks like this:\n",
+ "\n",
+ "```python\n",
+ "{\"55 Cnc b\":\"55 Cnc\",\"55 Cnc c\":\"55 Cnc\",\"DMPP-1 b\":\"DMPP-1\",\"GJ 876 b\":\"GJ 876\",\"GJ 876 c\":\"GJ 876\"}\n",
+ "```\n",
+ "\n",
+ "This file contains a *mapping* from each *planet* in `planets_1.csv` to the *star* in `stars_1.csv` that the planet orbits. Similarly, `mapping_2.json` contains a *mapping* from each *planet* in `planets_2.csv` to the *star* in `stars_2.csv` that the planet orbits, and `mapping_3.json` contains a *mapping* from each *planet* in `planets_3.csv` to the *star* in `stars_3.csv` that the planet orbits."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "fb233a29",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Questions and Functions:\n",
+ "\n",
+ "Let us start by importing all the modules we will need for this project."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "48449d80",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.604464Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.604464Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.612646Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.611632Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# it is considered a good coding practice to place all import statements at the top of the notebook\n",
+ "# place all your import statements in this cell if you need to import any more modules for this project\n",
+ "\n",
+ "# we have imported these modules for you\n",
+ "import os\n",
+ "from collections import namedtuple\n",
+ "import csv\n",
+ "import json"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bc993948",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Segment 2: File handling with the `os` module\n",
+ "\n",
+ "In this segment, you will learn how to use the `os` module effectively."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "fc4413e2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 1**: List **all** the files and directories in the directory `small_data` using the `os.listdir` function.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**. The order does **not** matter."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a2539165",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.617648Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.617648Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.629189Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.628176Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "all_files = os.listdir('small_data')\n",
+ "\n",
+ "all_files"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "734a79cd",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q1\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2b87295e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Important Warning:** That appeared to work just fine, but you should be **very careful** when using the `os` module. You might have noticed that there are files and directories in the list returned by `os.listdir` that **begin** with the character `\".\"` (specifically in this case, the file `\".DS_Store\"` and the directory `\".ipynb_checkpoints\"`). Such files and directories are used by some operating systems to store metadata. These files are not actually a part of your dataset, and must be **ignored**. \n",
+ "\n",
+ "When you are processing the files in any directory, you **must** always **ignore** such files that begin with the character `\".\"`, as they are not actually files in the directory. You **must** do this every time you use `os.listdir`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "288e7746",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 2**: List **all** the files and directories in the directory `small_data` that do **not** **start with** the character`\".\"`.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**. The order does **not** matter."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9283d54a",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.648992Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.648992Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.657926Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.656914Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'actual_files', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2e7dfe5e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q2\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "404b6b33",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Important Warning:** You are not done yet. Look at the order in which the files in the **list** `actual_files` are stored. The **ordering** of the files in the **list** returned by `os.listdir` **depends on the operating system**. This means that if you run this code on a **different OS**, the files might be sorted in a **different order**. This makes `os.listdir` a little dangerous because you could write something like `actual_files[0]` in your code, and it will always work the same way on your computer, but will **behave differently on another computer**. To avoid these issues, you should make sure that you always **explicitly sort** the output of `os.listdir` before you use it. This will ensure that the ordering remains consistent across all operating systems.\n",
+ "\n",
+ "When you are processing the files in any directory, you **must** always **explicitly sort** the output of `os.listdir` first. You **must** do this every time you use `os.listdir`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "cfc0f108",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 3**: List **all** the files and directories in the directory `small_data` that do **not** **start with** the character`\".\"`, sorted in **reverse alphabetical order**.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**, sorted in **reverse alphabetical** order."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "ce9a6977",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.673488Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.673488Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.681456Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.680441Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'files_in_small_data', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6c4fd974",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q3\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "fa90b33e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 4**: What is the **path** of the file `stars_1.csv` in the directory `small_data`.\n",
+ "\n",
+ "You are **allowed** to 'hardcode' the strings `'small_data'` and `'stars_1.csv'` to answer this question.\n",
+ "\n",
+ "**Warnings:**\n",
+ "\n",
+ "1. You **must not** hardcode the **absolute path** of any file in your code. For instance, the **absolute path** of this file `stars_1.csv` could be: `C:\\Users\\mdoescher\\cs220\\lab-p10\\small_data\\stars_1.csv`. However, if you hardcode this path in your code, it will **only work on your computer**. In this case, since the notebook `lab-p10.ipynb` is stored in the path `C:\\Users\\mdoescher\\cs220\\lab-p10`, the **relative path** of the file is `small_data\\stars_1.csv`, and this is the path that **must** be used, if you want your code to work on all computers.\n",
+ "2. You **must not** hardcode either the character `\"\\\"` or the character `\"/\"` in your paths. If you do so, your code will **crash** when it runs on a **different operating system**. You **must** use the `os.path.join` function to create path strings."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f315e5b6",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.705136Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.704137Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.715695Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.714682Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "stars_1_path = os.path.join(\"small_data\", \"stars_1.csv\")\n",
+ "\n",
+ "stars_1_path"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e31630a3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q4\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "15da3e0d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 5**: List the **paths** of **all** the files in the directory `small_data`.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**. You must **ignore** files that **start with** the character`\".\"`, and your output **must** be sorted in **reverse alphabetical order**.\n",
+ "\n",
+ "**Warnings:**\n",
+ "\n",
+ "1. You **must not** hardcode the **absolute path** of any file in your code. You must use the **relative path** of the files.\n",
+ "2. You **must not** hardcode either the character `\"\\\"` or the character `\"/\"` in your paths. You **must** use the `os.path.join` function to create paths."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "c5ba072e",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.740598Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.739600Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.748239Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.747227Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'paths_in_small_data', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6e4da4db",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q5\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "acbf604e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 6**: List the **paths** of **all** the JSON files in the directory `small_data`.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**. You must **ignore** files that **start with** the character`\".\"`, and your output **must** sorted in **reverse alphabetical order**.\n",
+ "\n",
+ "**Hint:** You can identify the JSON files as the files which end with the string `\".json\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d270a2e3",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.767956Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.766957Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.777083Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.776074Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'json_paths', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "169ea981",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q6\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e504581c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 7**: List the **paths** of **all** the files in the directory `small_data`, whose filename starts with `\"stars\"`.\n",
+ "\n",
+ "Your output **must** be a **list** of **strings**. You must **ignore** files that **start with** the character`\".\"`, and your output **must** sorted in **reverse alphabetical order**."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "07940c2e",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.796490Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.795489Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.808026Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.807009Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'stars_paths', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "7cad68a4",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q7\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0a754680",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Segment 3: Creating Namedtuples\n",
+ "\n",
+ "In P10, you will be reading the data in files similar to `stars_1.csv`, `stars_2.csv`, and `stars_3.csv`, and storing the data as a **dictionary** of **named tuples**. Now would be a great time to practice creating similar data structues."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d9a69e4f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 1: namedtuple `Star`\n",
+ "\n",
+ "We will now create a new `Star` type (using `namedtuple`). It **must** have the following attributes:\n",
+ "\n",
+ "* `spectral_type`,\n",
+ "* `stellar_effective_temperature`,\n",
+ "* `stellar_radius`,\n",
+ "* `stellar_mass`,\n",
+ "* `stellar_luminosity`,\n",
+ "* `stellar_surface_gravity`,\n",
+ "* `stellar_age`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "03da7912",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.825269Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.825269Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.832306Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.831295Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "# define the list of attributes we want in our namedtuple\n",
+ "star_attributes = ['spectral_type',\n",
+ " 'stellar_effective_temperature',\n",
+ " 'stellar_radius',\n",
+ " 'stellar_mass',\n",
+ " 'stellar_luminosity',\n",
+ " 'stellar_surface_gravity',\n",
+ " 'stellar_age']\n",
+ "\n",
+ "# create the namedtuple type 'Star' with the correct attributes\n",
+ "Star = namedtuple(\"Star\", star_attributes)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a07ae1f3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "Let us now test whether we have defined the namedtuple properly by creating a `Star` object."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f561d50b",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.838308Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.837310Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.847410Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.846400Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# run this following cell to initialize and test an example Star object\n",
+ "\n",
+ "sun = Star('G2 V', 5780.0, 1.0, 1.0, 0.0, 4.44, 4.6)\n",
+ "\n",
+ "sun"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "124f519f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"Star\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c8fe3393",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.1: Creating `Star` objects from `stars_1.csv`\n",
+ "\n",
+ "Now that we have created the `Star` namedtuple, our next objective will be to read the files `stars_1.csv`, `stars_2.csv`, and `stars_3.csv` and create `Star` objects out of all the stars in there. In order to process the CSV files, you will first need to copy/paste the `process_csv` function you have been using since P6."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8aa239c1",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.863492Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.863492Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.870927Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.869911Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# copy & paste the process_csv file from previous projects here\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e517862e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "You are now ready to read the data in `stars_1.csv` using `process_csv` and convert the data into `Star` objects. In the cell below, you **must** read the data in `stars_1.csv` and extract the **header** and the non-header **rows** of the file."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e913e4ea",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.879929Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.878929Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.887166Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.886155Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "stars_1_csv = process_csv(os.path.join(\"small_data\", \"stars_1.csv\")) # read the data in 'stars_1.csv'\n",
+ "stars_header = ...\n",
+ "stars_1_rows = ..."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "46b644cd",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the file and defined the variables correctly, you can check that `stars_header` has the value:\n",
+ "\n",
+ "```python\n",
+ "['Star Name', 'Spectral Type', 'Stellar Effective Temperature [K]', 'Stellar Radius [Solar Radius]', \n",
+ " 'Stellar Mass [Solar mass]', 'Stellar Luminosity [log(Solar)]', 'Stellar Surface Gravity [log10(cm/s**2)]',\n",
+ " 'Stellar Age [Gyr]']\n",
+ "```\n",
+ "\n",
+ "and that `stars_1_rows` has the value:\n",
+ "\n",
+ "```python\n",
+ "[['55 Cnc', 'G8V', '5172.00', '0.94', '0.91', '-0.197', '4.43', '10.200'],\n",
+ " ['DMPP-1', 'F8V', '6196.00', '1.26', '1.21', '0.320', '4.41', '2.010'],\n",
+ " ['GJ 876', 'M2.5V', '3271.00', '0.30', '0.32', '-1.907', '4.87', '1.000']]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1c093a04",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 8**: Create a `Star` object for the **first** star in `\"stars_1.csv\"`.\n",
+ "\n",
+ "The **attribute** of the `Star` namedtuple object, the corresponding **column** of the `stars_1.csv` file where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Attribute of `Star` object|Column of `stars_1.csv`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`spectral_type`|Spectral Type|**string**|\n",
+ "|`stellar_effective_temperature`|Stellar Effective Temperature [K]|**float**|\n",
+ "|`stellar_radius`|Stellar Radius [Solar Radius]|**float**|\n",
+ "|`stellar_mass`|Stellar Mass [Solar mass]|**float**|\n",
+ "|`stellar_luminosity`|Stellar Luminosity [log(Solar)]|**float**|\n",
+ "|`stellar_surface_gravity`|Stellar Surface Gravity [log10(cm/s**2)]|**float**|\n",
+ "|`stellar_age`|Stellar Age [Gyr]|**float**|"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f2ce62c2",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.893167Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.892166Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.905692Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.904681Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "row_idx = 0 # the index of the star we want to convert into a Star object\n",
+ "\n",
+ "# extract the values from stars_1_rows\n",
+ "spectral_type = stars_1_rows[row_idx][stars_header.index(...)]\n",
+ "stellar_effective_temperature = float(stars_1_rows[row_idx][stars_header.index(...)])\n",
+ "stellar_radius = ...\n",
+ "stellar_mass = ...\n",
+ "stellar_luminosity = ...\n",
+ "stellar_surface_gravity = ...\n",
+ "stellar_age = ...\n",
+ "\n",
+ "# initialize 'first_star'\n",
+ "first_star = Star(spectral_type, stellar_effective_temperature, stellar_radius, \\\n",
+ " stellar_mass, stellar_luminosity, \\\n",
+ " stellar_surface_gravity, stellar_age)\n",
+ "\n",
+ "first_star"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "af0985c5",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q8\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "90fc47c3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 9**: Create a `Star` object for the **second** star in `\"stars_1.csv\"`.\n",
+ "\n",
+ "You **must** create the `Star` object similarly to what you did in the previous question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5314bd44",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.923080Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.922079Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.933977Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.932967Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'second_star', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3257ccb4",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q9\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "782b3175",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 10**: What is the `spectral_type` of the **second** star in `\"stars_1.csv\"`?\n",
+ "\n",
+ "You **must** answer this question by accessing the correct **attribute** of the `Star` object `second_star`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "93256002",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.949375Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.948373Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.955310Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.955310Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "second_star_spectral_type = second_star.spectral_type\n",
+ "\n",
+ "second_star_spectral_type"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e399b365",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q10\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1e3272b8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 11**: What is the `stellar_age` of the **first** star in `\"stars_1.csv\"`?\n",
+ "\n",
+ "You **must** answer this question by accessing the correct **attribute** of the `Star` object `first_star`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8a22b382",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.971477Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.970477Z",
+ "iopub.status.idle": "2023-11-04T18:31:20.978275Z",
+ "shell.execute_reply": "2023-11-04T18:31:20.977263Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'first_star_stellar_age', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "c9d471a6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q11\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9e0bd9f2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 12**: What is the **ratio** of the `stellar_radius` of the **first** star in `\"stars_1.csv\"` to the **second** star in `\"stars_1.csv\"`?\n",
+ "\n",
+ "You **must** answer this question by accessing the correct **attribute** of the `Star` objects `first_star` and `second_star`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "c67a29c5",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:20.993595Z",
+ "iopub.status.busy": "2023-11-04T18:31:20.992596Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.002202Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.001189Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'stellar_radius_ratio', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1afeab22",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q12\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3c85c397",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 13**: Create a **dictionary** mapping the `name` of each star in `\"stars_1.csv\"` to its `Star` object.\n",
+ "\n",
+ "Your output **must** look like this:\n",
+ "```python\n",
+ "{'55 Cnc': Star(spectral_type='G8V', stellar_effective_temperature=5172.0, stellar_radius=0.94, \n",
+ " stellar_mass=0.91, stellar_luminosity=-0.197, stellar_surface_gravity=4.43, stellar_age=10.2),\n",
+ " 'DMPP-1': Star(spectral_type='F8V', stellar_effective_temperature=6196.0, stellar_radius=1.26, \n",
+ " stellar_mass=1.21, stellar_luminosity=0.32, stellar_surface_gravity=4.41, stellar_age=2.01),\n",
+ " 'GJ 876': Star(spectral_type='M2.5V', stellar_effective_temperature=3271.0, stellar_radius=0.3, \n",
+ " stellar_mass=0.32, stellar_luminosity=-1.907, stellar_surface_gravity=4.87, stellar_age=1.0)}\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "134dcc62",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.018575Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.017573Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.031533Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.030521Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "stars_1_dict = {} # initialize empty dictionary to store all stars\n",
+ "\n",
+ "for row_idx in range(len(stars_1_rows)):\n",
+ " star_name = stars_1_rows[row_idx][stars_header.index(...)]\n",
+ " spectral_type = ...\n",
+ " stellar_effective_temperature = ...\n",
+ " # extract the other columns from 'stars_1_rows'\n",
+ " \n",
+ " star = ... # initialize the 'Star' object using the variables defined above\n",
+ " stars_1_dict[...] = star\n",
+ "\n",
+ "stars_1_dict"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e70bcc38",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q13\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4b5cd61d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 14**: What is the `Star` object of the star (in `stars_1.csv`) named *GJ 876*?\n",
+ "\n",
+ "You **must** access the `Star` object in `stars_1_dict` **dictionary** defined above to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1a1991bd",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.047647Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.047647Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.055344Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.054332Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'gj_876', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "c8548752",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q14\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "34333560",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 15**: What is the `stellar_luminosity` of the star (in `stars_1.csv`) named *GJ 876*?\n",
+ "\n",
+ "You **must** access the `Star` object in `stars_1_dict` **dictionary** defined above to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "ec4581f3",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.071703Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.071703Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.078596Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.078596Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'gj_876_luminosity', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "89c84497",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q15\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "08555312",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.2: Data Cleaning - missing data\n",
+ "\n",
+ "We have already parsed the data in `stars_1.csv`. We are now ready to parse the data in **all** the star files of the `small_data` directory. However, there is one minor inconvenience - there is some missing data in `stars_2.csv` and `stars_3.csv`. For example, this is the **first** row of `stars_2.csv`:\n",
+ "\n",
+ "```python\n",
+ "['HD 158259', 'G0', '5801.89', '1.21', '1.08', '0.212', '4.25', '']\n",
+ "```\n",
+ "\n",
+ "As you can see, the value of the last column (`Stellar Age [Gyr]`) is `''`, which means that the data is missing. When the data is missing, we will want the value of the corresponding attribute in the `Star` object to be `None`.\n",
+ "\n",
+ "So, for example, if we are to convert the row above to be a `Star` object, it should look like:\n",
+ "\n",
+ "```python\n",
+ "Star(spectral_type='G0', stellar_effective_temperature=5801.89, stellar_radius=1.21, stellar_mass=1.08,\n",
+ " stellar_luminosity=0.212, stellar_surface_gravity=4.25, stellar_age=None)\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4e1c86b7",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 1: `star_cell(row_idx, col_name, stars_rows, header=stars_header)`\n",
+ "\n",
+ "Since we need to clean the values of the **list** of **lists** `stars_rows` before we can create our required data structure (**dictionary** mapping **strings** to `Star` objects), now would be a good time to create a function that takes in a `row_idx`, a `col_name` and a **list** of **lists** `stars_rows` (as well as the optional argument `header`) and returns the value of the column `col_name` at the row `row_idx`.\n",
+ "\n",
+ "This function **must** typecast the values it returns based on the `col_name`. If the value in `stars_rows` is missing (i.e., it is `''`), then the value returned **must** be `None`.\n",
+ "\n",
+ "Recall that the **column** of `stars_rows` where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Column of `stars_rows`|Data Type|\n",
+ "|------|---------|\n",
+ "|Star Name|**string**|\n",
+ "|Spectral Type|**string**|\n",
+ "|Stellar Effective Temperature [K]|**float**|\n",
+ "|Stellar Radius [Solar Radius]|**float**|\n",
+ "|Stellar Mass [Solar mass]|**float**|\n",
+ "|Stellar Luminosity [log(Solar)]|**float**|\n",
+ "|Stellar Surface Gravity [log10(cm/s**2)]|**float**|\n",
+ "|Stellar Age [Gyr]|**float**|\n",
+ "\n",
+ "**Hint:** You can use the `cell` function defined in P6 and P7 for inspiration here."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "57e495be",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.095472Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.095472Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.103336Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.102325Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "# the default argument to the parameter 'header' is the global variable 'stars_header' defined above\n",
+ "def star_cell(row_idx, col_name, stars_rows, header=stars_header):\n",
+ " col_idx = header.index(...)\n",
+ " val = stars_rows[row_idx][col_idx]\n",
+ " # return None if value is missing\n",
+ " # else typecast 'val' and return it depending on 'col_name'"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "763686e9",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 16**: Use the `star_cell` function to find the value of the column `\"Spectral Type\"` of the **first** star in `\"stars_2.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "56b65ea5",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.107335Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.107335Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.116140Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.115124Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "# first read the data in 'stars_2.csv' as a list of lists\n",
+ "stars_2_data = process_csv(os.path.join(\"small_data\", \"stars_2.csv\"))\n",
+ "stars_2_rows = stars_2_data[1:]\n",
+ "\n",
+ "# use the 'star_cell' function to extract the correct value\n",
+ "first_star_type = star_cell(0, 'Spectral Type', stars_2_rows)\n",
+ "\n",
+ "first_star_type"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3241ca1a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q16\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "501c9b4d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 17**: Use the `star_cell` function to find the value of the column `\"Stellar Age [Gyr]\"` of the **second** star in `\"stars_2.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "0d1d8b72",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.137145Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.136148Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.142798Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.141786Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "# do not worry if there is no output, the variable is expected to hold the value None\n",
+ "\n",
+ "# use the 'star_cell' function to extract the correct value\n",
+ "second_star_age = star_cell(1, 'Stellar Age [Gyr]', stars_2_rows)\n",
+ "\n",
+ "second_star_age"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "b6b7c9e6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q17\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "15d28bae",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 18**: Use the `star_cell` function to find the value of the column `\"Stellar Mass [Solar mass]\"` of the **third** star in `\"stars_2.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a0b1d827",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.164416Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.163415Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.173854Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.172840Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "# use the 'star_cell' function to extract the correct value\n",
+ "third_star_mass = star_cell(2, 'Stellar Mass [Solar mass]', stars_2_rows)\n",
+ "\n",
+ "third_star_mass"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f163f294",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q18\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e43b2f70",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 19**: Create a **dictionary** mapping the `name` of each star in `\"stars_2.csv\"` to its `Star` object.\n",
+ "\n",
+ "You **must** use the `star_cell` function to extract data from `stars_2.csv`.\n",
+ "\n",
+ "Your output **must** look like this:\n",
+ "```python\n",
+ "{'HD 158259': Star(spectral_type='G0', stellar_effective_temperature=5801.89, stellar_radius=1.21, \n",
+ " stellar_mass=1.08, stellar_luminosity=0.212, stellar_surface_gravity=4.25, stellar_age=None),\n",
+ " 'K2-187': Star(spectral_type=None, stellar_effective_temperature=5438.0, stellar_radius=0.83, \n",
+ " stellar_mass=0.97, stellar_luminosity=-0.21, stellar_surface_gravity=4.6, stellar_age=None),\n",
+ " 'WASP-47': Star(spectral_type=None, stellar_effective_temperature=5552.0, stellar_radius=1.14, \n",
+ " stellar_mass=1.04, stellar_luminosity=0.032, stellar_surface_gravity=4.34, stellar_age=6.5)}\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "45b7e5c2",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.197085Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.197085Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.211162Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.210151Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "stars_2_dict = {} # initialize empty dictionary to store all stars\n",
+ "\n",
+ "for row_idx in range(len(stars_2_rows)):\n",
+ " star_name = star_cell(row_idx, 'Star Name', stars_2_rows)\n",
+ " spectral_type = ...\n",
+ " stellar_effective_temperature = ...\n",
+ " # extract the other columns from 'stars_2_rows'\n",
+ " \n",
+ " star = ... # initialize the 'Star' object using the variables defined above\n",
+ " stars_2_dict[...] = star\n",
+ "\n",
+ "stars_2_dict"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8177fa89",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q19\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1216c018",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 20**: Create a **dictionary** mapping the `name` of each star in `\"stars_3.csv\"` to its `Star` object.\n",
+ "\n",
+ "You **must** use the `star_cell` function to extract data from `stars_3.csv`.\n",
+ "\n",
+ "Your output **must** look like this:\n",
+ "```python\n",
+ "{'K2-133': Star(spectral_type='M1.5V', stellar_effective_temperature=3655.0, stellar_radius=0.46, \n",
+ " stellar_mass=0.46, stellar_luminosity=-1.479, stellar_surface_gravity=4.77, stellar_age=None),\n",
+ " 'K2-138': Star(spectral_type='G8V', stellar_effective_temperature=5356.3, stellar_radius=0.86, \n",
+ " stellar_mass=0.94, stellar_luminosity=-0.287, stellar_surface_gravity=4.54, stellar_age=2.8),\n",
+ " 'GJ 667 C': Star(spectral_type='M1.5V', stellar_effective_temperature=3350.0, stellar_radius=None, \n",
+ " stellar_mass=0.33, stellar_luminosity=-1.863, stellar_surface_gravity=4.69, stellar_age=2.0)}\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "94336d4f",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.228229Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.227230Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.240730Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.239719Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'stars_3_dict', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "58942905",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q20\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "87d0d814",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 21**: Combine the three **dictionaries** `stars_1_dict`, `stars_2_dict`, and `stars_3_dict` into a single **dictionary** with all the stars in the `small_data` directory."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "290facf3",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.257110Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.256110Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.266497Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.266497Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "stars_dict = ... # initialize an empty dictionary\n",
+ "stars_dict.update(...) # add stars_1_dict to stars_dict\n",
+ "# add stars_2_dict and stars_3_dict to stars_dict\n",
+ "\n",
+ "stars_dict"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a634804e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q21\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "cb80f37a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 2: namedtuple `Planet`\n",
+ "\n",
+ "Just as you did with the stars, you will be using named tuples to store the data about the planets in the `planets_1.csv`, `planets_2.csv`, and `planets_3.csv` files. Before you start reading these files however, you **must** create a new `Planet` type (using namedtuple). It **must** have the following attributes:\n",
+ "\n",
+ "* `planet_name`,\n",
+ "* `host_name`,\n",
+ "* `discovery_method`,\n",
+ "* `discovery_year`,\n",
+ "* `controversial_flag`,\n",
+ "* `orbital_period`,\n",
+ "* `planet_radius`,\n",
+ "* `planet_mass`,\n",
+ "* `semi_major_radius`,\n",
+ "* `eccentricity`,\n",
+ "* `equilibrium_temperature`\n",
+ "* `insolation_flux`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f2748264",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.285141Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.284140Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.291175Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.290166Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the namedtuple 'Planet' here\n",
+ "\n",
+ "planets_attributes = ... # initialize the list of attributes\n",
+ "\n",
+ "# define the namedtuple 'Planet'\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "dfe08fa0",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.295176Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.295176Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.303285Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.302273Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# run this following cell to initialize and test an example Planet object\n",
+ "# if this cell fails to execute, you have likely not defined the namedtuple 'Planet' correctly\n",
+ "jupiter = Planet('Jupiter', 'Sun', 'Imaging', 1610, False, 4333.0, 11.209, 317.828, 5.2038, 0.0489, 110, 0.0345)\n",
+ "\n",
+ "jupiter"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "4ad341be",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"Planet\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ed437cd7",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.3: Creating `Planet` objects\n",
+ "\n",
+ "We are now ready to read the files in the `small_data` directory and create `Planet` objects. Creating `Planet` objects however, is going to be more difficult than creating `Star` objects, because the data required to create a single `Planet` object is split up into different files.\n",
+ "\n",
+ "The `planets_1.csv`, `planets_2.csv`, and `planets_3.csv` files contain all the data required to create `Planet` objects **except** for the `host_name`. The `host_name` for each planet is to be found in the `mapping_1.json`, `mapping_2.json`, and `mapping_3.json` files."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "418c826f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "First, let us read the data in `planets_1.csv`. Since this is a CSV file, you can use the `process_csv` function from above to read this file. In the cell below, you **must** read the data in `planets_1.csv` and extract the **header** and the non-header **rows** of the file."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3b4a9d38",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 22**: Read the contents of `'planets_1.csv'` into a **list** of **lists** using the `process_csv` function, and extract the **header** and the **rows** in the file."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "bb5fe960",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.321312Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.320306Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.328084Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.327073Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "planets_1_csv = process_csv(...) # read the data in 'planets_1.csv'\n",
+ "planets_header = ...\n",
+ "planets_1_rows = ..."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "821a1f7e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q22\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2049dbfd",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "Now, you are ready to read the data in `mapping_1.json`. Since this is a JSON file, you will need a new function to read this file:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "b7ab3301",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.345064Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.344065Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.350424Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.349413Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "# this function uses the 'load' function from the json module (already imported in this notebook) to read files\n",
+ "def read_json(path):\n",
+ " with open(path, encoding=\"utf-8\") as f:\n",
+ " return json.load(f)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8659adf2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 23**: Read the contents of `'mapping_1.json'` into a **dictionary** using the `read_json` function."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "147e2924",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.355425Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.354428Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.364394Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.363382Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this for you\n",
+ "\n",
+ "mapping_1_json = read_json(os.path.join(\"small_data\", \"mapping_1.json\"))\n",
+ "\n",
+ "mapping_1_json"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6cf69463",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q23\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "f413cd28",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.4: Combining data from CSV and JSON files\n",
+ "\n",
+ "We are now ready to combine the data from `planets_1_rows` and `mapping_1_json` to create `Planet` objects. Before we start, it might be useful to create a function similar to `star_cell` for preprocessing the values in the CSV files."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4f6044d2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 2: `planet_cell(row_idx, col_name, planets_rows, header=planets_header)`\n",
+ "\n",
+ "Just like the data in `stars_1.csv`, `stars_2.csv`, and `stars_3.csv`, some of the data in `planets_1.csv`, `planets_2.csv`, and `planets_3.csv` is **missing**. So, now would be a good time to create a function that takes in a `row_idx`, a `col_name` and a **list** of **lists** `planets_rows` (as well as the optional argument `header`) and returns the value of the column `col_name` at the row `row_idx`.\n",
+ "\n",
+ "This function **must** typecast the values it returns based on the `col_name`. If the value in `planets_rows` is missing (i.e., it is `''`), then the value returned **must** be `None`.\n",
+ "\n",
+ "The **column** of `planets_rows` where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Column of `planets_rows`|Data Type|\n",
+ "|------|---------|\n",
+ "|Planet Name|**string**|\n",
+ "|Discovery Year|**int**|\n",
+ "|Discovery Method|**string**|\n",
+ "|Controversial Flag|**bool**|\n",
+ "|Orbital Period [days]|**float**|\n",
+ "|Planet Radius [Earth Radius]|**float**|\n",
+ "|Planet Mass [Earth Mass]|**float**|\n",
+ "|Orbit Semi-Major Axis [au]|**float**|\n",
+ "|Eccentricity|**float**|\n",
+ "|Equilibrium Temperature [K]|**float**|\n",
+ "|Insolation Flux [Earth Flux]|**float**|\n",
+ "\n",
+ "**Important Warning:** Notice that the `Controversial Flag` column has to be converted into a **bool**. The data is stored in `planets_1.csv` (and consequently in `planets_rows`) as `\"0\"/\"1\"` values (with `\"0\"` representing `False` and `\"1\"` representing `True`). However typecasting **strings** to **bools** is not straightforward. Run the following cell and try to figure out what is happening:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "dff7b4a9",
+ "metadata": {
+ "deletable": false,
+ "editable": false,
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.382575Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.382575Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.391608Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.389595Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "strings = [\"0\", \"1\", \"\", \" \", \"True\", \"False\"]\n",
+ "for string in strings:\n",
+ " print(bool(string))"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1a940371",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you want to convert the **strings** into **bools**, you will have to explicitly use `if/else` statements to determine whether the value is `\"0\"` or `\"1\"`, as can be seen in the starter code below:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3069bccd",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.399605Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.398607Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.408902Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.407885Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "def planet_cell(row_idx, col_name, planets_rows, header=planets_header):\n",
+ " col_idx = ... # extract col_idx from col_name and header\n",
+ " val = ... # extract the value at row_idx and col_idx\n",
+ " if val == '':\n",
+ " return None\n",
+ " if col_name in [\"Controversial Flag\"]:\n",
+ " if val == \"1\":\n",
+ " return ...\n",
+ " else:\n",
+ " return ...\n",
+ " # for all other columns typecast 'val' and return it depending on col_name"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c8d81a8a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 24**: Use the `planet_cell` function to find the value of the column `\"Planet Name\"` of the **first** planet in `\"planets_1.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9debe1fa",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.415902Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.414902Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.426645Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.425626Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "first_planet_name = planet_cell(0, 'Planet Name', planets_1_rows)\n",
+ "\n",
+ "first_planet_name"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e7d83ea2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q24\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b40d6274",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 25**: Use the `planet_cell` function to find the value of the column `\"Insolation Flux [Earth Flux]\"` of the **first** planet in `\"planets_1.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "fb490a1f",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.444512Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.443511Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.451416Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.450747Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "# do not worry if there is no output, the variable is expected to hold the value None\n",
+ "\n",
+ "first_planet_flux = planet_cell(0, 'Insolation Flux [Earth Flux]', planets_1_rows)\n",
+ "\n",
+ "first_planet_flux"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "cf8585d5",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q25\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8b24bcda",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 26**: Use the `planet_cell` function to find the value of the column `\"Controversial Flag\"` of the **second** planet in `\"planets_1.csv\"`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "fe557bd6",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.470265Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.469265Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.479630Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.478615Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'second_planet_controversy', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "bfe7339d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q26\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "87f5ae58",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 27**: Create a `Planet` object for the **first** star in `\"planets_1.csv\"`.\n",
+ "\n",
+ "The **attribute** of the `Planet` namedtuple object, the corresponding **column** of the `planets_1.csv` file where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Attribute of `Planet` object|Column of `planets_1.csv`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`planet_name`|Planet Name|**string**|\n",
+ "|`host_name`| - |**string**|\n",
+ "|`discovery_method`|Discovery Method|**string**|\n",
+ "|`discovery_year`|Discovery Year|**int**|\n",
+ "|`controversial_flag`|Controversial Flag|**bool**|\n",
+ "|`orbital_period`|Orbital Period [days]|**float**|\n",
+ "|`planet_radius`|Planet Radius [Earth Radius]|**float**|\n",
+ "|`planet_mass`|Planet Mass [Earth Mass]|**float**|\n",
+ "|`semi_major_radius`|Orbit Semi-Major Axis [au]|**float**|\n",
+ "|`eccentricity`|Eccentricity|**float**|\n",
+ "|`equilibrium_temperature`|Equilibrium Temperature [K]|**float**|\n",
+ "|`insolation_flux`|Insolation Flux [Earth Flux]|**float**|\n",
+ "\n",
+ "\n",
+ "The value of the `host_name` attribute is found in `mapping_1.json`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "b66cf1f7",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.499507Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.498506Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.514441Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.513428Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "row_idx = 0 # the index of the planet we want to convert into a Planet object\n",
+ "\n",
+ "# extract the values from planets_1_rows\n",
+ "planet_name = planet_cell(row_idx, 'Planet Name', planets_1_rows)\n",
+ "host_name = mapping_1_json[planet_name]\n",
+ "discovery_method = planet_cell(row_idx, 'Discovery Method', planets_1_rows)\n",
+ "discovery_year = ...\n",
+ "controversial_flag = ...\n",
+ "orbital_period = ...\n",
+ "planet_radius = ...\n",
+ "planet_mass = ...\n",
+ "semi_major_radius = ...\n",
+ "eccentricity = ...\n",
+ "equilibrium_temperature = ...\n",
+ "insolation_flux = ...\n",
+ "\n",
+ "# initialize 'first_planet'\n",
+ "first_planet = Planet(planet_name, host_name, discovery_method, discovery_year,\\\n",
+ " controversial_flag, orbital_period, planet_radius, planet_mass,\\\n",
+ " semi_major_radius, eccentricity, equilibrium_temperature, insolation_flux)\n",
+ "\n",
+ "first_planet"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "63d00846",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q27\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bc475a2e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 28**: Create a **list** of `Planet` objects of each planet in `\"planets_1.csv\"`.\n",
+ "\n",
+ "Your output **must** look like this:\n",
+ "```python\n",
+ "[Planet(planet_name='55 Cnc b', host_name='55 Cnc', discovery_method='Radial Velocity', \n",
+ " discovery_year=1996, controversial_flag=False, orbital_period=14.6516, \n",
+ " planet_radius=13.9, planet_mass=263.9785, semi_major_radius=0.1134, eccentricity=0.0,\n",
+ " equilibrium_temperature=700.0, insolation_flux=None),\n",
+ " Planet(planet_name='55 Cnc c', host_name='55 Cnc', discovery_method='Radial Velocity', \n",
+ " discovery_year=2004, controversial_flag=False, orbital_period=44.3989, \n",
+ " planet_radius=8.51, planet_mass=54.4738, semi_major_radius=0.2373, eccentricity=0.03, \n",
+ " equilibrium_temperature=None, insolation_flux=None),\n",
+ " Planet(planet_name='DMPP-1 b', host_name='DMPP-1', discovery_method='Radial Velocity', \n",
+ " discovery_year=2019, controversial_flag=False, orbital_period=18.57, \n",
+ " planet_radius=5.29, planet_mass=24.27, semi_major_radius=0.1462, eccentricity=0.083, \n",
+ " equilibrium_temperature=877.0, insolation_flux=None),\n",
+ " Planet(planet_name='GJ 876 b', host_name='GJ 876', discovery_method='Radial Velocity', \n",
+ " discovery_year=1998, controversial_flag=False, orbital_period=61.1166, \n",
+ " planet_radius=13.3, planet_mass=723.2235, semi_major_radius=0.208317, eccentricity=0.0324,\n",
+ " equilibrium_temperature=None, insolation_flux=None),\n",
+ " Planet(planet_name='GJ 876 c', host_name='GJ 876', discovery_method='Radial Velocity', \n",
+ " discovery_year=2000, controversial_flag=False, orbital_period=30.0881, \n",
+ " planet_radius=14.0, planet_mass=226.9846, semi_major_radius=0.12959, eccentricity=0.25591, \n",
+ " equilibrium_temperature=None, insolation_flux=None)]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "af0c689c",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.536073Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.536073Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.552781Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.551771Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'planets_1_list', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "180671d1",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q28\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4a71cb3f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 29**: What is the **fifth** `Planet` object in `'planets_1.csv'`?\n",
+ "\n",
+ "You **must** access from the `planets_1_list` to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9658a259",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.577746Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.576747Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.588561Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.587547Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'fifth_planet', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "14a7483d",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q29\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a43d30a6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 30**: What is the `planet_name` of the **fifth** `Planet` in `'planets_1.csv'`?\n",
+ "\n",
+ "You **must** access from the `planets_1_list` to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "06b05ef5",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.614367Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.613368Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.624426Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.623410Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'fifth_planet_name', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3b61fa54",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q30\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "dc5c8fbc",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 31**: What is the `controversial_flag` of the **fourth** `Planet` in `'planets_1.csv'`?\n",
+ "\n",
+ "You **must** access from the `planets_1_list` to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8691a7d6",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.651046Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.650046Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.661414Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.660400Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'fourth_planet_controversy', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "55fe3856",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q31\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "56abdbf1",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.5: Data Cleaning - broken CSV rows\n",
+ "\n",
+ "The code you have written worked well for reading the data in `planets_1.csv` and `mapping_1.json`. However, it will likely **not** work for `planets_2.csv` and `mapping_2.json`. This is because the file `planets_2.csv` is **broken**. For some reason, a few rows in `planets_2.csv` have their data jumbled up. This is what `planets_2.csv` looks like:\n",
+ "\n",
+ "|Planet Name|Discovery Method|Discovery Year|Controversial Flag|Orbital Period [days]|Planet Radius [Earth Radius]|Planet Mass [Earth Mass]|Orbit Semi-Major Axis [au]|Eccentricity|Equilibrium Temperature [K]|Insolation Flux [Earth Flux]|\n",
+ "|-----------|----------------|--------------|------------------|---------------------|----------------------------|------------------------|--------------------------|------------|---------------------------|----------------------------|\n",
+ "|HD 158259 b|Radial Velocity|2020|0|2.17800000|1.292|2.22000|||1478|794.22|\n",
+ "|K2-187 b|Transit|2018|0|0.77401000|1.200|1.87000|0.016400||1815||\n",
+ "|K2-187 c|Transit|2018|0|2.87151200|1.400|2.54000|0.039200||1173||\n",
+ "|K2-187 d|K2-187|Transit|2018|0|7.14958400|2.400|6.35000|0.072000||865|\n",
+ "|WASP-47 b|2012|Transit|0|4.15914920|12.640|363.60000|0.052000|0.002800|1275|534.00|\n",
+ "\n",
+ "We can see that for some reason, in the **fourth** row, the value under the column `Discovery Method` is the name of the planet's host star. This is causing all the other columns in the row to also take meaningless values.\n",
+ "\n",
+ "Similarly, in the **fifth** row, we see that the values under the columns `Discovery Method` and `Discovery Year` are swapped.\n",
+ "\n",
+ "We will call such a **row** in a CSV file where the values under a column do not match the expected format to be a **broken row**. While it is possible to sometimes extract useful data from broken rows, in this lab and in P10, we will simply **skip** broken rows.\n",
+ "\n",
+ "In order to **skip** broken rows, you should first know how to recognize a **broken row**. In general, there is no general rule that helps you identify when a row is broken. This is because CSV rows can be **broken** in all sorts of different ways. Thankfully, we don't have to write code to catch all sorts of weird cases. It will suffice for us to manually **inspect** the file `planets_2.csv`, and identify **how** the rows are broken.\n",
+ "\n",
+ "The simplest way to recognize if a row is broken is if you run into any **RunTime Errors** when you execute your code. So, one simple way to skip bad rows would be to use `try/except` blocks to avoid processing any rows that cause the code to crash.\n",
+ "\n",
+ "**Important Note:** In this dataset, as you might have already noticed, it would be **significantly harder** to detect **broken rows** where some of the numerical values are swapped (for example, `Planet Radius [Earth Radius]` and `Planet Mass [Earth Mass]`). You may **assume** that the numerical values are **not** swapped in **any** row, and that **only the rows** in which the **data types** are not as expected are **broken**."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "89325183",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 32**: Create a **list** of `Planet` objects of each planet in `\"planets_2.csv\"`.\n",
+ "\n",
+ "You **must** skip any broken rows in the CSV file. Your output **must** look like this:\n",
+ "```python\n",
+ "[Planet(planet_name='HD 158259 b', host_name='HD 158259', discovery_method='Radial Velocity', \n",
+ " discovery_year=2020, controversial_flag=False, orbital_period=2.178, \n",
+ " planet_radius=1.292, planet_mass=2.22, semi_major_radius=None, eccentricity=None, \n",
+ " equilibrium_temperature=1478.0, insolation_flux=794.22),\n",
+ " Planet(planet_name='K2-187 b', host_name='K2-187', discovery_method='Transit', \n",
+ " discovery_year=2018, controversial_flag=False, orbital_period=0.77401, \n",
+ " planet_radius=1.2, planet_mass=1.87, semi_major_radius=0.0164, eccentricity=None, \n",
+ " equilibrium_temperature=1815.0, insolation_flux=None),\n",
+ " Planet(planet_name='K2-187 c', host_name='K2-187', discovery_method='Transit', \n",
+ " discovery_year=2018, controversial_flag=False, orbital_period=2.871512, \n",
+ " planet_radius=1.4, planet_mass=2.54, semi_major_radius=0.0392, eccentricity=None, \n",
+ " equilibrium_temperature=1173.0, insolation_flux=None)]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "a4c36c6c",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.688594Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.687592Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.726918Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.725903Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "planets_2_data = ... # read planets_2.csv\n",
+ "planets_2_rows = ... # extract the rows from planets_2_data\n",
+ "mapping_2_json = ... # read mapping_2.json\n",
+ "\n",
+ "planets_2_list = []\n",
+ "for row_idx in range(len(planets_2_rows)):\n",
+ " try:\n",
+ " pass # replace with your code\n",
+ " # create a Planet object and append to 'planets_2_list'\n",
+ " except ValueError:\n",
+ " continue\n",
+ "\n",
+ "planets_2_list"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1f6776a3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q32\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ea2a40e6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Important Warning:** It is considered a bad coding practice to use *bare* `try/except` blocks. This means that you should **never** write code like this:\n",
+ "\n",
+ "```python\n",
+ "try:\n",
+ " # some code\n",
+ "except:\n",
+ " # some other code\n",
+ "```\n",
+ "\n",
+ "If you use *bare* `try/except` blocks, your code will seemingly work even if there are bugs in there, and it can get very hard to debug. You should always **explicitly** catch for specific errors like this:\n",
+ "\n",
+ "```python\n",
+ "try:\n",
+ " # some code\n",
+ "except ValueError:\n",
+ " # some other code\n",
+ "except IndexError:\n",
+ " # some other code\n",
+ "```\n",
+ "\n",
+ "This way, your code will still crash if there is some other unexpected bug in your code that needs to be fixed, and will only go to the `except` block if it runs into a `ValueError` or an `IndexError`. The starter code above already catches specifically for `ValueError`. You **must** continue this practice in P10 as well."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c7a86bc8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Segment 3.6: Data Cleaning - broken JSON files\n",
+ "\n",
+ "So far, we have written code that can read `planets_1.csv` and `mapping_1.json`, as well as `planets_2.csv` and `mapping_2.json`. However, if you try to read `mapping_3.json`, you are likely to run into some issues. This is because the file `mapping_3.json` is **broken**. Unlike **broken** CSV files, where we only had to skip the **broken rows**, it is much harder to parse **broken JSON files**. When a JSON file is **broken**, we often have no choice but to **skip the file entirely**.\n",
+ "\n",
+ "It is also not easy to detect if a JSON file is **broken** using `if` statements. The easiest is to simply try to read the file using the `read_json` function and check if the code crashes."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ce45caff",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 33**: Determine if the `'mapping_3.json'` file is **broken** using a `try/except` block."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9385a807",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.757619Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.756616Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.771455Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.769416Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# we have done this one for you\n",
+ "\n",
+ "try:\n",
+ " mapping_3_json = read_json(os.path.join(\"small_data\", \"mapping_3.json\"))\n",
+ "except json.JSONDecodeError:\n",
+ " mapping_3_json = {}\n",
+ " \n",
+ "mapping_3_json"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "115bdede",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q33\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "14baf23e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "In the above cell, note that in the `try/except` block, we specifically checked for the `json.JSONDecodeError`. This is the error that is thrown when you try to call `json.load` on a **broken** JSON file."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "648f3a93",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Segment 4: Data Analysis\n",
+ "\n",
+ "We have now managed to read all the data in the `small_data` directory. Now is the time to test if our data structures work!"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bc7ab671",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 34**: What is the `host_name` of the **second** planet in `'planets_2.csv'`?\n",
+ "\n",
+ "You **must** skip any broken rows. So, you can directly access from the list `planets_2_list` to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8775af92",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.797384Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.796386Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.809364Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.807351Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'second_planet_host', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "680fc9ea",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q34\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e557c06b",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 35**: What is the `Star` object of the **third** planet in `'planets_2.csv'`?\n",
+ "\n",
+ "You **must** skip any broken rows. So, you can directly access from the list `planets_2_list` to answer this question.\n",
+ "\n",
+ "**Hint:** You can use the `stars_dict` **dictionary** defined in q12.2 to find the `Star` object."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "de95be9c",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.836596Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.835596Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.846718Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.845701Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'third_planet_star', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d5ffad69",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q35\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6e1a4aa4",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 36**: What is the `stellar_radius` of the star around which the **first** planet in `'planets_1.csv'` orbits?\n",
+ "\n",
+ "You can directly access from the list `planets_1_list` to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f03feac1",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-04T18:31:21.876761Z",
+ "iopub.status.busy": "2023-11-04T18:31:21.875760Z",
+ "iopub.status.idle": "2023-11-04T18:31:21.886388Z",
+ "shell.execute_reply": "2023-11-04T18:31:21.884361Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'first_planet_star_radius', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6418cc60",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q36\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "05ac549f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Great work! You are now ready to start P10."
+ ]
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3 (ipykernel)",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.4"
+ },
+ "otter": {
+ "OK_FORMAT": true,
+ "tests": {
+ "Planet": {
+ "name": "Planet",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('Planet', jupiter)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "Star": {
+ "name": "Star",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('Star', sun)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q1": {
+ "name": "q1",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q1', all_files)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q10": {
+ "name": "q10",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q10', second_star_spectral_type)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q11": {
+ "name": "q11",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q11', second_star_spectral_type)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q12": {
+ "name": "q12",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q12', stellar_radius_ratio)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q13": {
+ "name": "q13",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q13', stars_1_dict)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q14": {
+ "name": "q14",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q14', gj_876)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q15": {
+ "name": "q15",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q15', gj_876_luminosity)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q16": {
+ "name": "q16",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q16', first_star_type)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q17": {
+ "name": "q17",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q17', second_star_age)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q18": {
+ "name": "q18",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q18', third_star_mass)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q19": {
+ "name": "q19",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q19', stars_2_dict)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q2": {
+ "name": "q2",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q2', actual_files)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q20": {
+ "name": "q20",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q20', stars_3_dict)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q21": {
+ "name": "q21",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q21', stars_dict)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q22": {
+ "name": "q22",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q22', {'planets_1_csv': planets_1_csv, 'planets_header': planets_header, 'planets_1_rows': planets_1_rows})\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q23": {
+ "name": "q23",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q23', mapping_1_json)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q24": {
+ "name": "q24",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q24', first_planet_name)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q25": {
+ "name": "q25",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q25', first_planet_flux)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q26": {
+ "name": "q26",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q26', second_planet_controversy)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q27": {
+ "name": "q27",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q27', first_planet)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q28": {
+ "name": "q28",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q28', planets_1_list)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q29": {
+ "name": "q29",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q29', fifth_planet)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q3": {
+ "name": "q3",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q3', files_in_small_data)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q30": {
+ "name": "q30",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q30', fifth_planet_name)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q31": {
+ "name": "q31",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q31', fourth_planet_controversy)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q32": {
+ "name": "q32",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q32', planets_2_list)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q33": {
+ "name": "q33",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q33', mapping_3_json)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q34": {
+ "name": "q34",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q34', second_planet_host)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q35": {
+ "name": "q35",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q35', third_planet_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q36": {
+ "name": "q36",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q36', first_planet_star_radius)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q4": {
+ "name": "q4",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q4', stars_1_path)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q5": {
+ "name": "q5",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q5', paths_in_small_data)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q6": {
+ "name": "q6",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q6', json_paths)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q7": {
+ "name": "q7",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q7', stars_paths)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q8": {
+ "name": "q8",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q8', first_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q9": {
+ "name": "q9",
+ "points": 5,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q9', second_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ }
+ }
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/lab-p10/public_tests.py b/lab-p10/public_tests.py
new file mode 100644
index 0000000..dadbbba
--- /dev/null
+++ b/lab-p10/public_tests.py
@@ -0,0 +1,1056 @@
+#!/usr/bin/python
+# +
+import os, json, math, copy
+from collections import namedtuple
+from bs4 import BeautifulSoup
+
+HIDDEN_FILE = os.path.join("hidden", "hidden_tests.py")
+if os.path.exists(HIDDEN_FILE):
+ import hidden.hidden_tests as hidn
+# -
+
+MAX_FILE_SIZE = 750 # units - KB
+REL_TOL = 6e-04 # relative tolerance for floats
+ABS_TOL = 15e-03 # absolute tolerance for floats
+TOTAL_SCORE = 100 # total score for the project
+
+DF_FILE = 'expected_dfs.html'
+PLOT_FILE = 'expected_plots.json'
+
+PASS = "All test cases passed!"
+
+TEXT_FORMAT = "TEXT_FORMAT" # question type when expected answer is a type, str, int, float, or bool
+TEXT_FORMAT_UNORDERED_LIST = "TEXT_FORMAT_UNORDERED_LIST" # question type when the expected answer is a list or a set where the order does *not* matter
+TEXT_FORMAT_ORDERED_LIST = "TEXT_FORMAT_ORDERED_LIST" # question type when the expected answer is a list or tuple where the order does matter
+TEXT_FORMAT_DICT = "TEXT_FORMAT_DICT" # question type when the expected answer is a dictionary
+TEXT_FORMAT_SPECIAL_ORDERED_LIST = "TEXT_FORMAT_SPECIAL_ORDERED_LIST" # question type when the expected answer is a list where order does matter, but with possible ties. Elements are ordered according to values in special_ordered_json (with ties allowed)
+TEXT_FORMAT_NAMEDTUPLE = "TEXT_FORMAT_NAMEDTUPLE" # question type when expected answer is a namedtuple
+PNG_FORMAT_SCATTER = "PNG_FORMAT_SCATTER" # question type when the expected answer is a scatter plot
+HTML_FORMAT = "HTML_FORMAT" # question type when the expected answer is a DataFrame
+FILE_JSON_FORMAT = "FILE_JSON_FORMAT" # question type when the expected answer is a JSON file
+SLASHES = " SLASHES" # question SUFFIX when expected answer contains paths with slashes
+
+def get_expected_format():
+ """get_expected_format() returns a dict mapping each question to the format
+ of the expected answer."""
+ expected_format = {'q1': 'TEXT_FORMAT_UNORDERED_LIST',
+ 'q2': 'TEXT_FORMAT_UNORDERED_LIST',
+ 'q3': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q4': 'TEXT_FORMAT_SLASHES',
+ 'q5': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'q6': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'q7': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'Star': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q8': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q9': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q10': 'TEXT_FORMAT',
+ 'q11': 'TEXT_FORMAT',
+ 'q12': 'TEXT_FORMAT',
+ 'q13': 'TEXT_FORMAT_DICT',
+ 'q14': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q15': 'TEXT_FORMAT',
+ 'q16': 'TEXT_FORMAT',
+ 'q17': 'TEXT_FORMAT',
+ 'q18': 'TEXT_FORMAT',
+ 'q19': 'TEXT_FORMAT_DICT',
+ 'q20': 'TEXT_FORMAT_DICT',
+ 'q21': 'TEXT_FORMAT_DICT',
+ 'Planet': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q22': 'TEXT_FORMAT_DICT',
+ 'q23': 'TEXT_FORMAT_DICT',
+ 'q24': 'TEXT_FORMAT',
+ 'q25': 'TEXT_FORMAT',
+ 'q26': 'TEXT_FORMAT',
+ 'q27': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q28': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q29': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q30': 'TEXT_FORMAT',
+ 'q31': 'TEXT_FORMAT',
+ 'q32': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q33': 'TEXT_FORMAT_DICT',
+ 'q34': 'TEXT_FORMAT',
+ 'q35': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q36': 'TEXT_FORMAT'}
+ return expected_format
+
+
+def get_expected_json():
+ """get_expected_json() returns a dict mapping each question to the expected
+ answer (if the format permits it)."""
+ expected_json = {'q1': ['.DS_Store',
+ '.ipynb_checkpoints',
+ 'mapping_1.json',
+ 'mapping_2.json',
+ 'mapping_3.json',
+ 'planets_1.csv',
+ 'planets_2.csv',
+ 'planets_3.csv',
+ 'small_data.zip',
+ 'stars_1.csv',
+ 'stars_2.csv',
+ 'stars_3.csv'],
+ 'q2': ['mapping_1.json',
+ 'mapping_2.json',
+ 'mapping_3.json',
+ 'planets_1.csv',
+ 'planets_2.csv',
+ 'planets_3.csv',
+ 'small_data.zip',
+ 'stars_1.csv',
+ 'stars_2.csv',
+ 'stars_3.csv'],
+ 'q3': ['stars_3.csv',
+ 'stars_2.csv',
+ 'stars_1.csv',
+ 'small_data.zip',
+ 'planets_3.csv',
+ 'planets_2.csv',
+ 'planets_1.csv',
+ 'mapping_3.json',
+ 'mapping_2.json',
+ 'mapping_1.json'],
+ 'q4': 'small_data\\stars_1.csv',
+ 'q5': ['small_data\\stars_3.csv',
+ 'small_data\\stars_2.csv',
+ 'small_data\\stars_1.csv',
+ 'small_data\\small_data.zip',
+ 'small_data\\planets_3.csv',
+ 'small_data\\planets_2.csv',
+ 'small_data\\planets_1.csv',
+ 'small_data\\mapping_3.json',
+ 'small_data\\mapping_2.json',
+ 'small_data\\mapping_1.json'],
+ 'q6': ['small_data\\mapping_3.json',
+ 'small_data\\mapping_2.json',
+ 'small_data\\mapping_1.json'],
+ 'q7': ['small_data\\stars_3.csv',
+ 'small_data\\stars_2.csv',
+ 'small_data\\stars_1.csv'],
+ 'Star': Star(spectral_type='G2 V', stellar_effective_temperature=5780.0, stellar_radius=1.0, stellar_mass=1.0, stellar_luminosity=0.0, stellar_surface_gravity=4.44, stellar_age=4.6),
+ 'q8': Star(spectral_type='G8V', stellar_effective_temperature=5172.0, stellar_radius=0.94, stellar_mass=0.91, stellar_luminosity=-0.197, stellar_surface_gravity=4.43, stellar_age=10.2),
+ 'q9': Star(spectral_type='F8V', stellar_effective_temperature=6196.0, stellar_radius=1.26, stellar_mass=1.21, stellar_luminosity=0.32, stellar_surface_gravity=4.41, stellar_age=2.01),
+ 'q10': 'F8V',
+ 'q11': 'F8V',
+ 'q12': 0.7460317460317459,
+ 'q13': {'55 Cnc': Star(spectral_type='G8V', stellar_effective_temperature=5172.0, stellar_radius=0.94, stellar_mass=0.91, stellar_luminosity=-0.197, stellar_surface_gravity=4.43, stellar_age=10.2),
+ 'DMPP-1': Star(spectral_type='F8V', stellar_effective_temperature=6196.0, stellar_radius=1.26, stellar_mass=1.21, stellar_luminosity=0.32, stellar_surface_gravity=4.41, stellar_age=2.01),
+ 'GJ 876': Star(spectral_type='M2.5V', stellar_effective_temperature=3271.0, stellar_radius=0.3, stellar_mass=0.32, stellar_luminosity=-1.907, stellar_surface_gravity=4.87, stellar_age=1.0)},
+ 'q14': Star(spectral_type='M2.5V', stellar_effective_temperature=3271.0, stellar_radius=0.3, stellar_mass=0.32, stellar_luminosity=-1.907, stellar_surface_gravity=4.87, stellar_age=1.0),
+ 'q15': -1.907,
+ 'q16': 'G0',
+ 'q17': None,
+ 'q18': 1.04,
+ 'q19': {'HD 158259': Star(spectral_type='G0', stellar_effective_temperature=5801.89, stellar_radius=1.21, stellar_mass=1.08, stellar_luminosity=0.212, stellar_surface_gravity=4.25, stellar_age=None),
+ 'K2-187': Star(spectral_type=None, stellar_effective_temperature=5438.0, stellar_radius=0.83, stellar_mass=0.97, stellar_luminosity=-0.21, stellar_surface_gravity=4.6, stellar_age=None),
+ 'WASP-47': Star(spectral_type=None, stellar_effective_temperature=5552.0, stellar_radius=1.14, stellar_mass=1.04, stellar_luminosity=0.032, stellar_surface_gravity=4.34, stellar_age=6.5)},
+ 'q20': {'K2-133': Star(spectral_type='M1.5V', stellar_effective_temperature=3655.0, stellar_radius=0.46, stellar_mass=0.46, stellar_luminosity=-1.479, stellar_surface_gravity=4.77, stellar_age=None),
+ 'K2-138': Star(spectral_type='G8V', stellar_effective_temperature=5356.3, stellar_radius=0.86, stellar_mass=0.94, stellar_luminosity=-0.287, stellar_surface_gravity=4.54, stellar_age=2.8),
+ 'GJ 667 C': Star(spectral_type='M1.5V', stellar_effective_temperature=3350.0, stellar_radius=None, stellar_mass=0.33, stellar_luminosity=-1.863, stellar_surface_gravity=4.69, stellar_age=2.0)},
+ 'q21': {'55 Cnc': Star(spectral_type='G8V', stellar_effective_temperature=5172.0, stellar_radius=0.94, stellar_mass=0.91, stellar_luminosity=-0.197, stellar_surface_gravity=4.43, stellar_age=10.2),
+ 'DMPP-1': Star(spectral_type='F8V', stellar_effective_temperature=6196.0, stellar_radius=1.26, stellar_mass=1.21, stellar_luminosity=0.32, stellar_surface_gravity=4.41, stellar_age=2.01),
+ 'GJ 876': Star(spectral_type='M2.5V', stellar_effective_temperature=3271.0, stellar_radius=0.3, stellar_mass=0.32, stellar_luminosity=-1.907, stellar_surface_gravity=4.87, stellar_age=1.0),
+ 'HD 158259': Star(spectral_type='G0', stellar_effective_temperature=5801.89, stellar_radius=1.21, stellar_mass=1.08, stellar_luminosity=0.212, stellar_surface_gravity=4.25, stellar_age=None),
+ 'K2-187': Star(spectral_type=None, stellar_effective_temperature=5438.0, stellar_radius=0.83, stellar_mass=0.97, stellar_luminosity=-0.21, stellar_surface_gravity=4.6, stellar_age=None),
+ 'WASP-47': Star(spectral_type=None, stellar_effective_temperature=5552.0, stellar_radius=1.14, stellar_mass=1.04, stellar_luminosity=0.032, stellar_surface_gravity=4.34, stellar_age=6.5),
+ 'K2-133': Star(spectral_type='M1.5V', stellar_effective_temperature=3655.0, stellar_radius=0.46, stellar_mass=0.46, stellar_luminosity=-1.479, stellar_surface_gravity=4.77, stellar_age=None),
+ 'K2-138': Star(spectral_type='G8V', stellar_effective_temperature=5356.3, stellar_radius=0.86, stellar_mass=0.94, stellar_luminosity=-0.287, stellar_surface_gravity=4.54, stellar_age=2.8),
+ 'GJ 667 C': Star(spectral_type='M1.5V', stellar_effective_temperature=3350.0, stellar_radius=None, stellar_mass=0.33, stellar_luminosity=-1.863, stellar_surface_gravity=4.69, stellar_age=2.0)},
+ 'Planet': Planet(planet_name='Jupiter', host_name='Sun', discovery_method='Imaging', discovery_year=1610, controversial_flag=False, orbital_period=4333.0, planet_radius=11.209, planet_mass=317.828, semi_major_radius=5.2038, eccentricity=0.0489, equilibrium_temperature=110, insolation_flux=0.0345),
+ 'q22': {'planets_1_csv': [['Planet Name',
+ 'Discovery Method',
+ 'Discovery Year',
+ 'Controversial Flag',
+ 'Orbital Period [days]',
+ 'Planet Radius [Earth Radius]',
+ 'Planet Mass [Earth Mass]',
+ 'Orbit Semi-Major Axis [au]',
+ 'Eccentricity',
+ 'Equilibrium Temperature [K]',
+ 'Insolation Flux [Earth Flux]'],
+ ['55 Cnc b',
+ 'Radial Velocity',
+ '1996',
+ '0',
+ '14.65160000',
+ '13.900',
+ '263.97850',
+ '0.113400',
+ '0.000000',
+ '700',
+ ''],
+ ['55 Cnc c',
+ 'Radial Velocity',
+ '2004',
+ '0',
+ '44.39890000',
+ '8.510',
+ '54.47380',
+ '0.237300',
+ '0.030000',
+ '',
+ ''],
+ ['DMPP-1 b',
+ 'Radial Velocity',
+ '2019',
+ '0',
+ '18.57000000',
+ '5.290',
+ '24.27000',
+ '0.146200',
+ '0.083000',
+ '877',
+ ''],
+ ['GJ 876 b',
+ 'Radial Velocity',
+ '1998',
+ '0',
+ '61.11660000',
+ '13.300',
+ '723.22350',
+ '0.208317',
+ '0.032400',
+ '',
+ ''],
+ ['GJ 876 c',
+ 'Radial Velocity',
+ '2000',
+ '0',
+ '30.08810000',
+ '14.000',
+ '226.98460',
+ '0.129590',
+ '0.255910',
+ '',
+ '']],
+ 'planets_header': ['Planet Name',
+ 'Discovery Method',
+ 'Discovery Year',
+ 'Controversial Flag',
+ 'Orbital Period [days]',
+ 'Planet Radius [Earth Radius]',
+ 'Planet Mass [Earth Mass]',
+ 'Orbit Semi-Major Axis [au]',
+ 'Eccentricity',
+ 'Equilibrium Temperature [K]',
+ 'Insolation Flux [Earth Flux]'],
+ 'planets_1_rows': [['55 Cnc b',
+ 'Radial Velocity',
+ '1996',
+ '0',
+ '14.65160000',
+ '13.900',
+ '263.97850',
+ '0.113400',
+ '0.000000',
+ '700',
+ ''],
+ ['55 Cnc c',
+ 'Radial Velocity',
+ '2004',
+ '0',
+ '44.39890000',
+ '8.510',
+ '54.47380',
+ '0.237300',
+ '0.030000',
+ '',
+ ''],
+ ['DMPP-1 b',
+ 'Radial Velocity',
+ '2019',
+ '0',
+ '18.57000000',
+ '5.290',
+ '24.27000',
+ '0.146200',
+ '0.083000',
+ '877',
+ ''],
+ ['GJ 876 b',
+ 'Radial Velocity',
+ '1998',
+ '0',
+ '61.11660000',
+ '13.300',
+ '723.22350',
+ '0.208317',
+ '0.032400',
+ '',
+ ''],
+ ['GJ 876 c',
+ 'Radial Velocity',
+ '2000',
+ '0',
+ '30.08810000',
+ '14.000',
+ '226.98460',
+ '0.129590',
+ '0.255910',
+ '',
+ '']]},
+ 'q23': {'55 Cnc b': '55 Cnc',
+ '55 Cnc c': '55 Cnc',
+ 'DMPP-1 b': 'DMPP-1',
+ 'GJ 876 b': 'GJ 876',
+ 'GJ 876 c': 'GJ 876'},
+ 'q24': '55 Cnc b',
+ 'q25': None,
+ 'q26': False,
+ 'q27': Planet(planet_name='55 Cnc b', host_name='55 Cnc', discovery_method='Radial Velocity', discovery_year=1996, controversial_flag=False, orbital_period=14.6516, planet_radius=13.9, planet_mass=263.9785, semi_major_radius=0.1134, eccentricity=0.0, equilibrium_temperature=700.0, insolation_flux=None),
+ 'q28': [Planet(planet_name='55 Cnc b', host_name='55 Cnc', discovery_method='Radial Velocity', discovery_year=1996, controversial_flag=False, orbital_period=14.6516, planet_radius=13.9, planet_mass=263.9785, semi_major_radius=0.1134, eccentricity=0.0, equilibrium_temperature=700.0, insolation_flux=None),
+ Planet(planet_name='55 Cnc c', host_name='55 Cnc', discovery_method='Radial Velocity', discovery_year=2004, controversial_flag=False, orbital_period=44.3989, planet_radius=8.51, planet_mass=54.4738, semi_major_radius=0.2373, eccentricity=0.03, equilibrium_temperature=None, insolation_flux=None),
+ Planet(planet_name='DMPP-1 b', host_name='DMPP-1', discovery_method='Radial Velocity', discovery_year=2019, controversial_flag=False, orbital_period=18.57, planet_radius=5.29, planet_mass=24.27, semi_major_radius=0.1462, eccentricity=0.083, equilibrium_temperature=877.0, insolation_flux=None),
+ Planet(planet_name='GJ 876 b', host_name='GJ 876', discovery_method='Radial Velocity', discovery_year=1998, controversial_flag=False, orbital_period=61.1166, planet_radius=13.3, planet_mass=723.2235, semi_major_radius=0.208317, eccentricity=0.0324, equilibrium_temperature=None, insolation_flux=None),
+ Planet(planet_name='GJ 876 c', host_name='GJ 876', discovery_method='Radial Velocity', discovery_year=2000, controversial_flag=False, orbital_period=30.0881, planet_radius=14.0, planet_mass=226.9846, semi_major_radius=0.12959, eccentricity=0.25591, equilibrium_temperature=None, insolation_flux=None)],
+ 'q29': Planet(planet_name='GJ 876 c', host_name='GJ 876', discovery_method='Radial Velocity', discovery_year=2000, controversial_flag=False, orbital_period=30.0881, planet_radius=14.0, planet_mass=226.9846, semi_major_radius=0.12959, eccentricity=0.25591, equilibrium_temperature=None, insolation_flux=None),
+ 'q30': 'GJ 876 c',
+ 'q31': False,
+ 'q32': [Planet(planet_name='HD 158259 b', host_name='HD 158259', discovery_method='Radial Velocity', discovery_year=2020, controversial_flag=False, orbital_period=2.178, planet_radius=1.292, planet_mass=2.22, semi_major_radius=None, eccentricity=None, equilibrium_temperature=1478.0, insolation_flux=794.22),
+ Planet(planet_name='K2-187 b', host_name='K2-187', discovery_method='Transit', discovery_year=2018, controversial_flag=False, orbital_period=0.77401, planet_radius=1.2, planet_mass=1.87, semi_major_radius=0.0164, eccentricity=None, equilibrium_temperature=1815.0, insolation_flux=None),
+ Planet(planet_name='K2-187 c', host_name='K2-187', discovery_method='Transit', discovery_year=2018, controversial_flag=False, orbital_period=2.871512, planet_radius=1.4, planet_mass=2.54, semi_major_radius=0.0392, eccentricity=None, equilibrium_temperature=1173.0, insolation_flux=None)],
+ 'q33': {},
+ 'q34': 'K2-187',
+ 'q35': Star(spectral_type=None, stellar_effective_temperature=5438.0, stellar_radius=0.83, stellar_mass=0.97, stellar_luminosity=-0.21, stellar_surface_gravity=4.6, stellar_age=None),
+ 'q36': 0.94}
+ return expected_json
+
+
+def get_special_json():
+ """get_special_json() returns a dict mapping each question to the expected
+ answer stored in a special format as a list of tuples. Each tuple contains
+ the element expected in the list, and its corresponding value. Any two
+ elements with the same value can appear in any order in the actual list,
+ but if two elements have different values, then they must appear in the
+ same order as in the expected list of tuples."""
+ special_json = {}
+ return special_json
+
+
+def compare(expected, actual, q_format=TEXT_FORMAT):
+ """compare(expected, actual) is used to compare when the format of
+ the expected answer is known for certain."""
+ try:
+ if q_format == TEXT_FORMAT:
+ return simple_compare(expected, actual)
+ elif q_format == TEXT_FORMAT_UNORDERED_LIST:
+ return list_compare_unordered(expected, actual)
+ elif q_format == TEXT_FORMAT_ORDERED_LIST:
+ return list_compare_ordered(expected, actual)
+ elif q_format == TEXT_FORMAT_DICT:
+ return dict_compare(expected, actual)
+ elif q_format == TEXT_FORMAT_SPECIAL_ORDERED_LIST:
+ return list_compare_special(expected, actual)
+ elif q_format == TEXT_FORMAT_NAMEDTUPLE:
+ return namedtuple_compare(expected, actual)
+ elif q_format == PNG_FORMAT_SCATTER:
+ return compare_flip_dicts(expected, actual)
+ elif q_format == HTML_FORMAT:
+ return compare_cell_html(expected, actual)
+ elif q_format == FILE_JSON_FORMAT:
+ return compare_json(expected, actual)
+ else:
+ if expected != actual:
+ return "expected %s but found %s " % (repr(expected), repr(actual))
+ except:
+ if expected != actual:
+ return "expected %s" % (repr(expected))
+ return PASS
+
+
+def print_message(expected, actual, complete_msg=True):
+ """print_message(expected, actual) displays a simple error message."""
+ msg = "expected %s" % (repr(expected))
+ if complete_msg:
+ msg = msg + " but found %s" % (repr(actual))
+ return msg
+
+
+def simple_compare(expected, actual, complete_msg=True):
+ """simple_compare(expected, actual) is used to compare when the expected answer
+ is a type/Nones/str/int/float/bool. When the expected answer is a float,
+ the actual answer is allowed to be within the tolerance limit. Otherwise,
+ the values must match exactly, or a very simple error message is displayed."""
+ msg = PASS
+ if 'numpy' in repr(type((actual))):
+ actual = actual.item()
+ if isinstance(expected, type):
+ if expected != actual:
+ if isinstance(actual, type):
+ msg = "expected %s but found %s" % (expected.__name__, actual.__name__)
+ else:
+ msg = "expected %s but found %s" % (expected.__name__, repr(actual))
+ elif not isinstance(actual, type(expected)):
+ if not (isinstance(expected, (float, int)) and isinstance(actual, (float, int))):
+ if not is_namedtuple(expected):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ elif isinstance(expected, float):
+ if not math.isclose(actual, expected, rel_tol=REL_TOL, abs_tol=ABS_TOL):
+ msg = print_message(expected, actual, complete_msg)
+ elif isinstance(expected, (list, tuple)) or is_namedtuple(expected):
+ new_msg = print_message(expected, actual, complete_msg)
+ if len(expected) != len(actual):
+ return new_msg
+ for i in range(len(expected)):
+ val = simple_compare(expected[i], actual[i])
+ if val != PASS:
+ return new_msg
+ elif isinstance(expected, dict):
+ new_msg = print_message(expected, actual, complete_msg)
+ if len(expected) != len(actual):
+ return new_msg
+ val = simpe_compare(sorted(list(expected.keys())), sorted(list(actual.keys())))
+ if val != PASS:
+ return new_msg
+ for key in expected:
+ val = simple_compare(expected[key], actual[key])
+ if val != PASS:
+ return new_msg
+ else:
+ if expected != actual:
+ msg = print_message(expected, actual, complete_msg)
+ return msg
+
+
+def intelligent_compare(expected, actual, obj=None):
+ """intelligent_compare(expected, actual) is used to compare when the
+ data type of the expected answer is not known for certain, and default
+ assumptions need to be made."""
+ if obj == None:
+ obj = type(expected).__name__
+ if is_namedtuple(expected):
+ msg = namedtuple_compare(expected, actual)
+ elif isinstance(expected, (list, tuple)):
+ msg = list_compare_ordered(expected, actual, obj)
+ elif isinstance(expected, set):
+ msg = list_compare_unordered(expected, actual, obj)
+ elif isinstance(expected, (dict)):
+ msg = dict_compare(expected, actual)
+ else:
+ msg = simple_compare(expected, actual)
+ msg = msg.replace("CompDict", "dict").replace("CompSet", "set").replace("NewNone", "None")
+ return msg
+
+
+def is_namedtuple(obj, init_check=True):
+ """is_namedtuple(obj) returns True if `obj` is a namedtuple object
+ defined in the test file."""
+ bases = type(obj).__bases__
+ if len(bases) != 1 or bases[0] != tuple:
+ return False
+ fields = getattr(type(obj), '_fields', None)
+ if not isinstance(fields, tuple):
+ return False
+ if init_check and not type(obj).__name__ in [nt.__name__ for nt in _expected_namedtuples]:
+ return False
+ return True
+
+
+def list_compare_ordered(expected, actual, obj=None):
+ """list_compare_ordered(expected, actual) is used to compare when the
+ expected answer is a list/tuple, where the order of the elements matters."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+ for i in range(len(expected)):
+ if i >= len(actual):
+ msg = "at index %d of the %s, expected missing %s" % (i, obj, repr(expected[i]))
+ break
+ val = intelligent_compare(expected[i], actual[i], "sub" + obj)
+ if val != PASS:
+ msg = "at index %d of the %s, " % (i, obj) + val
+ break
+ if len(actual) > len(expected) and msg == PASS:
+ msg = "at index %d of the %s, found unexpected %s" % (len(expected), obj, repr(actual[len(expected)]))
+ if len(expected) != len(actual):
+ msg = msg + " (found %d entries in %s, but expected %d)" % (len(actual), obj, len(expected))
+
+ if len(expected) > 0:
+ try:
+ if msg != PASS and list_compare_unordered(expected, actual, obj) == PASS:
+ msg = msg + " (%s may not be ordered as required)" % (obj)
+ except:
+ pass
+ return msg
+
+
+def list_compare_helper(larger, smaller):
+ """list_compare_helper(larger, smaller) is a helper function which takes in
+ two lists of possibly unequal sizes and finds the item that is not present
+ in the smaller list, if there is such an element."""
+ msg = PASS
+ j = 0
+ for i in range(len(larger)):
+ if i == len(smaller):
+ msg = "expected %s" % (repr(larger[i]))
+ break
+ found = False
+ while not found:
+ if j == len(smaller):
+ val = simple_compare(larger[i], smaller[j - 1], complete_msg=False)
+ break
+ val = simple_compare(larger[i], smaller[j], complete_msg=False)
+ j += 1
+ if val == PASS:
+ found = True
+ break
+ if not found:
+ msg = val
+ break
+ return msg
+
+class NewNone():
+ """alternate class in place of None, which allows for comparison with
+ all other data types."""
+ def __str__(self):
+ return 'None'
+ def __repr__(self):
+ return 'None'
+ def __lt__(self, other):
+ return True
+ def __le__(self, other):
+ return True
+ def __gt__(self, other):
+ return False
+ def __ge__(self, other):
+ return other == None
+ def __eq__(self, other):
+ return other == None
+ def __ne__(self, other):
+ return other != None
+
+class CompDict(dict):
+ """subclass of dict, which allows for comparison with other dicts."""
+ def __init__(self, vals):
+ super(self.__class__, self).__init__(vals)
+ if type(vals) == CompDict:
+ self.val = vals.val
+ elif isinstance(vals, dict):
+ self.val = self.get_equiv(vals)
+ else:
+ raise TypeError("'%s' object cannot be type casted to CompDict class" % type(vals).__name__)
+
+ def get_equiv(self, vals):
+ val = []
+ for key in sorted(list(vals.keys())):
+ val.append((key, vals[key]))
+ return val
+
+ def __str__(self):
+ return str(dict(self.val))
+ def __repr__(self):
+ return repr(dict(self.val))
+ def __lt__(self, other):
+ return self.val < CompDict(other).val
+ def __le__(self, other):
+ return self.val <= CompDict(other).val
+ def __gt__(self, other):
+ return self.val > CompDict(other).val
+ def __ge__(self, other):
+ return self.val >= CompDict(other).val
+ def __eq__(self, other):
+ return self.val == CompDict(other).val
+ def __ne__(self, other):
+ return self.val != CompDict(other).val
+
+class CompSet(set):
+ """subclass of set, which allows for comparison with other sets."""
+ def __init__(self, vals):
+ super(self.__class__, self).__init__(vals)
+ if type(vals) == CompSet:
+ self.val = vals.val
+ elif isinstance(vals, set):
+ self.val = self.get_equiv(vals)
+ else:
+ raise TypeError("'%s' object cannot be type casted to CompSet class" % type(vals).__name__)
+
+ def get_equiv(self, vals):
+ return sorted(list(vals))
+
+ def __str__(self):
+ return str(set(self.val))
+ def __repr__(self):
+ return repr(set(self.val))
+ def __getitem__(self, index):
+ return self.val[index]
+ def __lt__(self, other):
+ return self.val < CompSet(other).val
+ def __le__(self, other):
+ return self.val <= CompSet(other).val
+ def __gt__(self, other):
+ return self.val > CompSet(other).val
+ def __ge__(self, other):
+ return self.val >= CompSet(other).val
+ def __eq__(self, other):
+ return self.val == CompSet(other).val
+ def __ne__(self, other):
+ return self.val != CompSet(other).val
+
+def make_sortable(item):
+ """make_sortable(item) replaces all Nones in `item` with an alternate
+ class that allows for comparison with str/int/float/bool/list/set/tuple/dict.
+ It also replaces all dicts (and sets) with a subclass that allows for
+ comparison with other dicts (and sets)."""
+ if item == None:
+ return NewNone()
+ elif isinstance(item, (type, str, int, float, bool)):
+ return item
+ elif isinstance(item, (list, set, tuple)):
+ new_item = []
+ for subitem in item:
+ new_item.append(make_sortable(subitem))
+ if is_namedtuple(item):
+ return type(item)(*new_item)
+ elif isinstance(item, set):
+ return CompSet(new_item)
+ else:
+ return type(item)(new_item)
+ elif isinstance(item, dict):
+ new_item = {}
+ for key in item:
+ new_item[key] = make_sortable(item[key])
+ return CompDict(new_item)
+ return item
+
+def list_compare_unordered(expected, actual, obj=None):
+ """list_compare_unordered(expected, actual) is used to compare when the
+ expected answer is a list/set where the order of the elements does not matter."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+
+ try:
+ sort_expected = sorted(make_sortable(expected))
+ sort_actual = sorted(make_sortable(actual))
+ except:
+ return "unexpected datatype found in %s; expected entries of type %s" % (obj, obj, type(expected[0]).__name__)
+
+ if len(actual) == 0 and len(expected) > 0:
+ msg = "in the %s, missing " % (obj) + sort_expected[0]
+ elif len(actual) > 0 and len(expected) > 0:
+ val = intelligent_compare(sort_expected[0], sort_actual[0])
+ if val.startswith("expected to find type"):
+ msg = "in the %s, " % (obj) + simple_compare(sort_expected[0], sort_actual[0])
+ else:
+ if len(expected) > len(actual):
+ msg = "in the %s, missing " % (obj) + list_compare_helper(sort_expected, sort_actual)
+ elif len(expected) < len(actual):
+ msg = "in the %s, found un" % (obj) + list_compare_helper(sort_actual, sort_expected)
+ if len(expected) != len(actual):
+ msg = msg + " (found %d entries in %s, but expected %d)" % (len(actual), obj, len(expected))
+ return msg
+ else:
+ val = list_compare_helper(sort_expected, sort_actual)
+ if val != PASS:
+ msg = "in the %s, missing " % (obj) + val + ", but found un" + list_compare_helper(sort_actual,
+ sort_expected)
+ return msg
+
+
+def namedtuple_compare(expected, actual):
+ """namedtuple_compare(expected, actual) is used to compare when the
+ expected answer is a namedtuple defined in the test file."""
+ msg = PASS
+ if not is_namedtuple(actual, False):
+ msg = "expected namedtuple but found %s" % (type(actual).__name__)
+ return msg
+ if type(expected).__name__ != type(actual).__name__:
+ return "expected namedtuple %s but found namedtuple %s" % (type(expected).__name__, type(actual).__name__)
+ expected_fields = expected._fields
+ actual_fields = actual._fields
+ msg = list_compare_ordered(list(expected_fields), list(actual_fields), "namedtuple attributes")
+ if msg != PASS:
+ return msg
+ for field in expected_fields:
+ val = intelligent_compare(getattr(expected, field), getattr(actual, field))
+ if val != PASS:
+ msg = "at attribute %s of namedtuple %s, " % (field, type(expected).__name__) + val
+ return msg
+ return msg
+
+
+def clean_slashes(item):
+ """clean_slashes()"""
+ if isinstance(item, str):
+ return item.replace("\\", "/").replace("/", os.path.sep)
+ elif item == None or isinstance(item, (type, int, float, bool)):
+ return item
+ elif isinstance(item, (list, tuple, set)) or is_namedtuple(item):
+ new_item = []
+ for subitem in item:
+ new_item.append(clean_slashes(subitem))
+ if is_namedtuple(item):
+ return type(item)(*new_item)
+ else:
+ return type(item)(new_item)
+ elif isinstance(item, dict):
+ new_item = {}
+ for key in item:
+ new_item[clean_slashes(key)] = clean_slashes(item[key])
+ return item
+
+
+def list_compare_special_initialize(special_expected):
+ """list_compare_special_initialize(special_expected) takes in the special
+ ordering stored as a sorted list of items, and returns a list of lists
+ where the ordering among the inner lists does not matter."""
+ latest_val = None
+ clean_special = []
+ for row in special_expected:
+ if latest_val == None or row[1] != latest_val:
+ clean_special.append([])
+ latest_val = row[1]
+ clean_special[-1].append(row[0])
+ return clean_special
+
+
+def list_compare_special(special_expected, actual):
+ """list_compare_special(special_expected, actual) is used to compare when the
+ expected answer is a list with special ordering defined in `special_expected`."""
+ msg = PASS
+ expected_list = []
+ special_order = list_compare_special_initialize(special_expected)
+ for expected_item in special_order:
+ expected_list.extend(expected_item)
+ val = list_compare_unordered(expected_list, actual)
+ if val != PASS:
+ return val
+ i = 0
+ for expected_item in special_order:
+ j = len(expected_item)
+ actual_item = actual[i: i + j]
+ val = list_compare_unordered(expected_item, actual_item)
+ if val != PASS:
+ if j == 1:
+ msg = "at index %d " % (i) + val
+ else:
+ msg = "between indices %d and %d " % (i, i + j - 1) + val
+ msg = msg + " (list may not be ordered as required)"
+ break
+ i += j
+ return msg
+
+
+def dict_compare(expected, actual, obj=None):
+ """dict_compare(expected, actual) is used to compare when the expected answer
+ is a dict."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+
+ expected_keys = list(expected.keys())
+ actual_keys = list(actual.keys())
+ val = list_compare_unordered(expected_keys, actual_keys, obj)
+
+ if val != PASS:
+ msg = "bad keys in %s: " % (obj) + val
+ if msg == PASS:
+ for key in expected:
+ new_obj = None
+ if isinstance(expected[key], (list, tuple, set)):
+ new_obj = 'value'
+ elif isinstance(expected[key], dict):
+ new_obj = 'sub' + obj
+ val = intelligent_compare(expected[key], actual[key], new_obj)
+ if val != PASS:
+ msg = "incorrect value for key %s in %s: " % (repr(key), obj) + val
+ return msg
+
+
+def is_flippable(item):
+ """is_flippable(item) determines if the given dict of lists has lists of the
+ same length and is therefore flippable."""
+ item_lens = set(([str(len(item[key])) for key in item]))
+ if len(item_lens) == 1:
+ return PASS
+ else:
+ return "found lists of lengths %s" % (", ".join(list(item_lens)))
+
+def flip_dict_of_lists(item):
+ """flip_dict_of_lists(item) flips a dict of lists into a list of dicts if the
+ lists are of same length."""
+ new_item = []
+ length = len(list(item.values())[0])
+ for i in range(length):
+ new_dict = {}
+ for key in item:
+ new_dict[key] = item[key][i]
+ new_item.append(new_dict)
+ return new_item
+
+def compare_flip_dicts(expected, actual, obj="lists"):
+ """compare_flip_dicts(expected, actual) flips a dict of lists (or dicts) into
+ a list of dicts (or dict of dicts) and then compares the list ignoring order."""
+ msg = PASS
+ example_item = list(expected.values())[0]
+ if isinstance(example_item, (list, tuple)):
+ val = is_flippable(actual)
+ if val != PASS:
+ msg = "expected to find lists of length %d, but " % (len(example_item)) + val
+ return msg
+ msg = list_compare_unordered(flip_dict_of_lists(expected), flip_dict_of_lists(actual), "lists")
+ elif isinstance(example_item, dict):
+ expected_keys = list(example_item.keys())
+ for key in actual:
+ val = list_compare_unordered(expected_keys, list(actual[key].keys()), "dictionary %s" % key)
+ if val != PASS:
+ return val
+ for cat_key in expected_keys:
+ expected_category = {}
+ actual_category = {}
+ for key in expected:
+ expected_category[key] = expected[key][cat_key]
+ actual_category[key] = actual[key][cat_key]
+ val = list_compare_unordered(flip_dict_of_lists(expected), flip_dict_of_lists(actual), "category " + repr(cat_key))
+ if val != PASS:
+ return val
+ return msg
+
+
+def get_expected_tables():
+ """get_expected_tables() reads the html file with the expected DataFrames
+ and returns a dict mapping each question to a html table."""
+ if not os.path.exists(DF_FILE):
+ return None
+
+ expected_tables = {}
+ f = open(DF_FILE, encoding='utf-8')
+ soup = BeautifulSoup(f.read(), 'html.parser')
+ f.close()
+
+ tables = soup.find_all('table')
+ for table in tables:
+ expected_tables[table.get("data-question")] = table
+
+ return expected_tables
+
+def parse_df_html_table(table):
+ """parse_df_html_table(table) takes in a table as a html string and returns
+ a dict mapping each row and column index to the value at that position."""
+ rows = []
+ for tr in table.find_all('tr'):
+ rows.append([])
+ for cell in tr.find_all(['td', 'th']):
+ rows[-1].append(cell.get_text().strip("\n "))
+
+ cells = {}
+ for r in range(1, len(rows)):
+ for c in range(1, len(rows[0])):
+ rname = rows[r][0]
+ cname = rows[0][c]
+ cells[(rname,cname)] = rows[r][c]
+ return cells
+
+
+def get_expected_namedtuples():
+ """get_expected_namedtuples() defines the required namedtuple objects
+ globally. It also returns a tuple of the classes."""
+ expected_namedtuples = []
+
+ global Star
+ star_attributes = ['spectral_type', 'stellar_effective_temperature', 'stellar_radius', 'stellar_mass', 'stellar_luminosity', 'stellar_surface_gravity', 'stellar_age']
+ Star = namedtuple('Star', star_attributes)
+ expected_namedtuples.append(Star)
+ global Planet
+ """# BEGIN PROMPT
+ planets_attributes = ... # initialize the list of attributes
+
+ # define the namedtuple 'Planet'
+ """
+ planets_attributes = ['planet_name', 'host_name', 'discovery_method', 'discovery_year', 'controversial_flag', 'orbital_period', 'planet_radius', 'planet_mass', 'semi_major_radius', 'eccentricity', 'equilibrium_temperature', 'insolation_flux']
+ Planet = namedtuple('Planet', planets_attributes)
+ expected_namedtuples.append(Planet)
+ return tuple(expected_namedtuples)
+
+_expected_namedtuples = get_expected_namedtuples()
+
+
+def compare_cell_html(expected, actual):
+ """compare_cell_html(expected, actual) is used to compare when the
+ expected answer is a DataFrame stored in the `expected_dfs` html file."""
+ expected_cells = parse_df_html_table(expected)
+ try:
+ actual_cells = parse_df_html_table(BeautifulSoup(actual, 'html.parser').find('table'))
+ except Exception as e:
+ return "expected to find type DataFrame but found type %s instead" % type(actual).__name__
+
+ expected_cols = list(set(["column %s" % (loc[1]) for loc in expected_cells]))
+ actual_cols = list(set(["column %s" % (loc[1]) for loc in actual_cells]))
+ msg = list_compare_unordered(expected_cols, actual_cols, "DataFrame")
+ if msg != PASS:
+ return msg
+
+ expected_rows = list(set(["row index %s" % (loc[0]) for loc in expected_cells]))
+ actual_rows = list(set(["row index %s" % (loc[0]) for loc in actual_cells]))
+ msg = list_compare_unordered(expected_rows, actual_rows, "DataFrame")
+ if msg != PASS:
+ return msg
+
+ for location, expected in expected_cells.items():
+ location_name = "column {} at index {}".format(location[1], location[0])
+ actual = actual_cells.get(location, None)
+ if actual == None:
+ return "in %s, expected to find %s" % (location_name, repr(expected))
+ try:
+ actual_ans = float(actual)
+ expected_ans = float(expected)
+ if math.isnan(actual_ans) and math.isnan(expected_ans):
+ continue
+ except Exception as e:
+ actual_ans, expected_ans = actual, expected
+ msg = simple_compare(expected_ans, actual_ans)
+ if msg != PASS:
+ return "in %s, " % location_name + msg
+ return PASS
+
+
+def get_expected_plots():
+ """get_expected_plots() reads the json file with the expected plot data
+ and returns a dict mapping each question to a dictionary with the plots data."""
+ if not os.path.exists(PLOT_FILE):
+ return None
+
+ f = open(PLOT_FILE, encoding='utf-8')
+ expected_plots = json.load(f)
+ f.close()
+ return expected_plots
+
+
+def compare_file_json(expected, actual):
+ """compare_file_json(expected, actual) is used to compare when the
+ expected answer is a JSON file."""
+ msg = PASS
+ if not os.path.isfile(expected):
+ return "file %s not found; make sure it is downloaded and stored in the correct directory" % (expected)
+ elif not os.path.isfile(actual):
+ return "file %s not found; make sure that you have created the file with the correct name" % (actual)
+ try:
+ e = open(expected, encoding='utf-8')
+ expected_data = json.load(e)
+ e.close()
+ except json.JSONDecodeError:
+ return "file %s is broken and cannot be parsed; please delete and redownload the file correctly" % (expected)
+ try:
+ a = open(actual, encoding='utf-8')
+ actual_data = json.load(a)
+ a.close()
+ except json.JSONDecodeError:
+ return "file %s is broken and cannot be parsed" % (actual)
+ if type(expected_data) == list:
+ msg = list_compare_ordered(expected_data, actual_data, 'file ' + actual)
+ elif type(expected_data) == dict:
+ msg = dict_compare(expected_data, actual_data)
+ return msg
+
+
+_expected_json = get_expected_json()
+_special_json = get_special_json()
+_expected_plots = get_expected_plots()
+_expected_tables = get_expected_tables()
+_expected_format = get_expected_format()
+
+def check(qnum, actual):
+ """check(qnum, actual) is used to check if the answer in the notebook is
+ the correct answer, and provide useful feedback if the answer is incorrect."""
+ msg = PASS
+ error_msg = "<b style='color: red;'>ERROR:</b> "
+ q_format = _expected_format[qnum]
+
+ if q_format == TEXT_FORMAT_SPECIAL_ORDERED_LIST:
+ expected = _special_json[qnum]
+ elif q_format == PNG_FORMAT_SCATTER:
+ if _expected_plots == None:
+ msg = error_msg + "file %s not parsed; make sure it is downloaded and stored in the correct directory" % (PLOT_FILE)
+ else:
+ expected = _expected_plots[qnum]
+ elif q_format == HTML_FORMAT:
+ if _expected_tables == None:
+ msg = error_msg + "file %s not parsed; make sure it is downloaded and stored in the correct directory" % (DF_FILE)
+ else:
+ expected = _expected_tables[qnum]
+ else:
+ expected = _expected_json[qnum]
+
+ if SLASHES in q_format:
+ q_format = q_format.replace(SLASHES, "").strip("_ ")
+ expected = clean_slashes(expected)
+ actual = clean_slashes(actual)
+
+ if msg != PASS:
+ print(msg)
+ else:
+ msg = compare(expected, actual, q_format)
+ if msg != PASS:
+ msg = error_msg + msg
+ print(msg)
+
+
+def check_file_size(path):
+ """check_file_size(path) throws an error if the file is too big to display
+ on Gradescope."""
+ size = os.path.getsize(path)
+ assert size < MAX_FILE_SIZE * 10**3, "Your file is too big to be displayed by Gradescope; please delete unnecessary output cells so your file size is < %s KB" % MAX_FILE_SIZE
+
+
+def reset_hidden_tests():
+ """reset_hidden_tests() resets all hidden tests on the Gradescope autograder where the hidden test file exists"""
+ if not os.path.exists(HIDDEN_FILE):
+ return
+ hidn.reset_hidden_tests()
+
+def rubric_check(rubric_point, ignore_past_errors=True):
+ """rubric_check(rubric_point) uses the hidden test file on the Gradescope autograder to grade the `rubric_point`"""
+ if not os.path.exists(HIDDEN_FILE):
+ print(PASS)
+ return
+ error_msg_1 = "ERROR: "
+ error_msg_2 = "TEST DETAILS: "
+ try:
+ msg = hidn.rubric_check(rubric_point, ignore_past_errors)
+ except:
+ msg = "hidden tests crashed before execution"
+ if msg != PASS:
+ hidn.make_deductions(rubric_point)
+ if msg == "public tests failed":
+ comment = "The public tests have failed, so you will not receive any points for this question."
+ comment += "\nPlease confirm that the public tests pass locally before submitting."
+ elif msg == "answer is hardcoded":
+ comment = "In the datasets for testing hardcoding, all numbers are replaced with random values."
+ comment += "\nIf the answer is the same as in the original dataset for all these datasets"
+ comment += "\ndespite this, that implies that the answer in the notebook is hardcoded."
+ comment += "\nYou will not receive any points for this question."
+ else:
+ comment = hidn.get_comment(rubric_point)
+ msg = error_msg_1 + msg
+ if comment != "":
+ msg = msg + "\n" + error_msg_2 + comment
+ print(msg)
+
+def get_summary():
+ """get_summary() returns the summary of the notebook using the hidden test file on the Gradescope autograder"""
+ if not os.path.exists(HIDDEN_FILE):
+ print("Total Score: %d/%d" % (TOTAL_SCORE, TOTAL_SCORE))
+ return
+ score = min(TOTAL_SCORE, hidn.get_score(TOTAL_SCORE))
+ display_msg = "Total Score: %d/%d" % (score, TOTAL_SCORE)
+ if score != TOTAL_SCORE:
+ display_msg += "\n" + hidn.get_deduction_string()
+ print(display_msg)
+
+def get_score_digit(digit):
+ """get_score_digit(digit) returns the `digit` of the score using the hidden test file on the Gradescope autograder"""
+ if not os.path.exists(HIDDEN_FILE):
+ score = TOTAL_SCORE
+ else:
+ score = hidn.get_score(TOTAL_SCORE)
+ digits = bin(score)[2:]
+ digits = "0"*(7 - len(digits)) + digits
+ return int(digits[6 - digit])
diff --git a/lab-p10/small_data.zip b/lab-p10/small_data.zip
new file mode 100644
index 0000000000000000000000000000000000000000..1002b336b815897990880ebe72ce305438750cfa
GIT binary patch
literal 3469
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
V4+ECVJTUnnVt}t`=D#h-e*iZm4?h3^
literal 0
HcmV?d00001
diff --git a/p10/README.md b/p10/README.md
new file mode 100644
index 0000000..d7822a1
--- /dev/null
+++ b/p10/README.md
@@ -0,0 +1,68 @@
+# Project 10 (P10): Looking at Stars and Planets
+
+
+## Corrections and clarifications:
+
+* None yet.
+
+**Find any issues?** Report to us:
+
+- Divyam Anshumaan <anshumaan@wisc.edu>
+- Samuel Guo <sguo258@wisc.edu>
+- Cathy Cao <ccao35@wisc.edu>
+- John Balis <balis@wisc.edu>
+- David Parra <deparra@wisc.edu>
+- Muhammad Musa <mmusa2@wisc.edu>
+
+
+## Instructions:
+
+This project will focus on **file handling**, **namedtuples**, **data cleaning** and **error handling**. To start, download [`p10.ipynb`](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/p10/p10.ipynb), [`public_tests.py`](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/p10/public_tests.py), and [`data.zip`](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/p10/data.zip).
+
+After downloading `data.zip`, make sure to extract it (using [Mac directions](http://osxdaily.com/2017/11/05/how-open-zip-file-mac/) or [Windows directions](https://support.microsoft.com/en-us/help/4028088/windows-zip-and-unzip-files)). After extracting, you should see a folder called `data`, which has the following files in it:
+
+* `.DS_Store`
+* `.ipynb_checkpoints`
+* `mapping_1.json`
+* `mapping_2.json`
+* `mapping_3.json`
+* `mapping_4.json`
+* `mapping_5.json`
+* `stars_1.csv`
+* `stars_2.csv`
+* `stars_3.csv`
+* `stars_4.csv`
+* `stars_5.csv`
+* `planets_1.csv`
+* `planets_2.csv`
+* `planets_3.csv`
+* `planets_4.csv`
+* `planets_5.csv`
+
+You may delete `data.zip` after extracting these files from it.
+
+You will work on `p10.ipynb` and hand it in. You should follow the provided directions for each question. Questions have **specific** directions on what **to do** and what **not to do**.
+
+**Important warning:** Since P10 deals heavily with file handling, whether or not the test cases pass depends greatly on the operating system being used. Even if your code passes all tests locally, it may **fail on Gradescope** if it uses a different operating system. To avoid these issues, **follow the instructions** in P10 carefully, and **after submission, check to see that all your test cases pass on the Gradescope autograder**.
+
+------------------------------
+
+## IMPORTANT Submission instructions:
+- Review the [Grading Rubric](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/p10/rubric.md), to ensure that you don't lose points during code review.
+- Login to [Gradescope](https://www.gradescope.com/) and upload the zip file into the P10 assignment.
+- If you completed the project with a **partner**, make sure to **add their name** by clicking "Add Group Member"
+in Gradescope when uploading the P10 zip file.
+
+ <img src="images/add_group_member.png" width="400">
+
+ **Warning:** You will have to add your partner on Gradescope even if you have filled out this information in your `p10.ipynb` notebook.
+
+- It is **your responsibility** to make sure that your project clears auto-grader tests on the Gradescope test system. Otter test results should be available within forty minutes after your submission (usually within ten minutes). **Ignore** the `-/100.00` that is displayed to the right. You should be able to see both PASS / FAIL results for the 20 test cases, which is accessible via Gradescope Dashboard (as in the image below):
+
+ <img src="images/gradescope.png" width="400">
+
+- You can view your **final score** at the **end of the page**. If you pass all tests, then you will receive **full points** for the project. Otherwise, you can see your final score in the **summary** section of the test results (as in the image below):
+
+ <img src="images/summary.png" width="400">
+
+ If you want more details on why you lost points on a particular test, you can scroll up to find more details about the test.
diff --git a/p10/data.zip b/p10/data.zip
new file mode 100644
index 0000000000000000000000000000000000000000..2ae59b171672e16cfd367d00b96d484c1268154d
GIT binary patch
literal 228004
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
literal 0
HcmV?d00001
diff --git a/p10/images/README.md b/p10/images/README.md
new file mode 100644
index 0000000..535f9c4
--- /dev/null
+++ b/p10/images/README.md
@@ -0,0 +1,7 @@
+# Images
+
+Images from p10 are stored here.
+
+```python
+
+```
diff --git a/p10/images/add_group_member.png b/p10/images/add_group_member.png
new file mode 100644
index 0000000000000000000000000000000000000000..402e5962e3e54ce8349f60ccfe4ce2b60840dd3b
GIT binary patch
literal 160694
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
G^#1`nq_8jm
literal 0
HcmV?d00001
diff --git a/p10/images/gradescope.png b/p10/images/gradescope.png
new file mode 100644
index 0000000000000000000000000000000000000000..7441faae41d8eb98bfceeb78855b67896b1ff911
GIT binary patch
literal 61912
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
literal 0
HcmV?d00001
diff --git a/p10/images/summary.png b/p10/images/summary.png
new file mode 100644
index 0000000000000000000000000000000000000000..4a63e32ff1a29903584746aa4873373855558e7b
GIT binary patch
literal 20543
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
literal 0
HcmV?d00001
diff --git a/p10/p10.ipynb b/p10/p10.ipynb
new file mode 100644
index 0000000..50ba848
--- /dev/null
+++ b/p10/p10.ipynb
@@ -0,0 +1,3421 @@
+{
+ "cells": [
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8b450944",
+ "metadata": {
+ "cell_type": "code",
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "# import and initialize otter\n",
+ "import otter\n",
+ "grader = otter.Notebook(\"p10.ipynb\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9ceb233f",
+ "metadata": {
+ "editable": false,
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:24.192731Z",
+ "iopub.status.busy": "2023-11-08T00:40:24.191733Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.523134Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.522142Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "import public_tests"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5b932bef",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.529138Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.529138Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.535135Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.534137Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "# PLEASE FILL IN THE DETAILS\n",
+ "# Enter none if you don't have a project partner\n",
+ "# You will have to add your partner as a group member on Gradescope even after you fill this\n",
+ "\n",
+ "# project: p10\n",
+ "# submitter: NETID1\n",
+ "# partner: NETID2"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0fe8fc95",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "# Project 10: Stars and Planets"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b84d0bbd",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Learning Objectives:\n",
+ "\n",
+ "In this project, you will demonstrate how to:\n",
+ "\n",
+ "* use `os` module to get information of files in a directory,\n",
+ "* use `os` module to get paths of files,\n",
+ "* look up data between JSON and CSV files using unique keys,\n",
+ "* read JSON and CSV files to store data to `namedTuple` objects,\n",
+ "* clean up missing values and handle cases when the file is too corrupt to parse,\n",
+ "\n",
+ "Please go through [Lab-P10](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/tree/main/lab-p10) before working on this project. The lab introduces some useful techniques related to this project."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e0df7cca",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "<h2 style=\"color:red\">Warning (Note on Academic Misconduct):</h2>\n",
+ "\n",
+ "**IMPORTANT**: **P10 and P11 are two parts of the same data analysis.** You **cannot** switch project partners between these two projects. That is if you partner up with someone for P10, you have to sustain that partnership until the end of P11. Now may be a good time to review [our course policies](https://cs220.cs.wisc.edu/f23/syllabus.html).\n",
+ "\n",
+ "Under any circumstances, **no more than two students are allowed to work together on a project** as mentioned in the course policies. If your code is flagged by our code similarity detection tools, **both partners will be responsible** for sharing/copying the code, even if the code is shared/copied by one of the partners with/from other non-partner student(s). Note that each case of plagiarism will be reported to the Dean of Students with a zero grade on the project. **If you think that someone cannot be your project partner then don’t make that student your lab partner.**\n",
+ "\n",
+ "**<font color = \"red\">Project partners must submit only one copy of their project on Gradescope, but they must include the names of both partners.</font>**"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e495f863",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Testing your code:\n",
+ "\n",
+ "Along with this notebook, you must have downloaded the file `public_tests.py`. If you are curious about how we test your code, you can explore this file, and specifically the output of the function `get_expected_json`, to understand the expected answers to the questions."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4bda5cf6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Setup:\n",
+ "\n",
+ "Before proceeding much further, download `data.zip` and extract it to a directory on your\n",
+ "computer (using [Mac directions](http://osxdaily.com/2017/11/05/how-open-zip-file-mac/) or\n",
+ "[Windows directions](https://support.microsoft.com/en-us/help/4028088/windows-zip-and-unzip-files)).\n",
+ "\n",
+ "You need to make sure that the project files are stored in the following structure:\n",
+ "\n",
+ "```\n",
+ "+-- p10.ipynb\n",
+ "+-- public_tests.py\n",
+ "+-- data\n",
+ "| +-- .DS_Store\n",
+ "| +-- .ipynb_checkpoints\n",
+ "| +-- mapping_1.json\n",
+ "| +-- mapping_2.json\n",
+ "| +-- mapping_3.json\n",
+ "| +-- mapping_4.json\n",
+ "| +-- mapping_5.json\n",
+ "| +-- planets_1.csv\n",
+ "| +-- planets_2.csv\n",
+ "| +-- planets_3.csv\n",
+ "| +-- planets_4.csv\n",
+ "| +-- planets_5.csv\n",
+ "| +-- stars_1.csv\n",
+ "| +-- stars_2.csv\n",
+ "| +-- stars_3.csv\n",
+ "| +-- stars_4.csv\n",
+ "| +-- stars_5.csv\n",
+ "```\n",
+ "\n",
+ "Make sure that the files inside `data.zip` are inside the `data` directory. If you place your files inside some other directory, then your code will **fail on Gradescope** even after passing local tests."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "be737015",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Project Description:\n",
+ "\n",
+ "Cleaning data is an important part of a data scientist's work cycle. As you have already seen, the data we will be analyzing in P10 and P11 has been split up into 15 different files of different formats. Even worse, as you shall see later in this project, some of these files have been corrupted, and lots of data is missing. Unfortunately, in the real world, a lot of data that you will come across will be in rough shape, and it is your job to clean it up before you can analyze it. In P10, you will combine the data in these different files to create a few manageable data structures, which can be easily analyzed. In the process, you will also have to deal with broken CSV files (by skipping rows with broken data), and broken JSON files (by skipping the files entirely).\n",
+ "\n",
+ "After you create these data structures, in P11, you will dive deeper by analyzing this data and arrive at some exciting conclusions about various planets and stars outside our Solar System."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1989d5d8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## The Data:\n",
+ "\n",
+ "In P10 and P11, you will be studying stars and planets outside our Solar System using this dataset from the [NASA Exoplanet Archive](https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TblView/nph-tblView?app=ExoTbls&config=PSCompPars). You will use Python to ask some interesting questions about the laws of the universe and explore the habitability of other planets in our universe. The raw data from the [NASA Exoplanet Archive](https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TblView/nph-tblView?app=ExoTbls&config=PSCompPars) has been parsed and stored in multiple different files of different formats. You can find these files inside `data.zip`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0fa6cb36",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "You can open each of these files using Microsoft Excel or some other Spreadsheet viewing software to see how the data is stored. For example, these are the first three rows of the file `stars_1.csv`:\n",
+ "\n",
+ "Star Name|Spectral Type|Stellar Effective Temperature [K]|Stellar Radius [Solar Radius]|Stellar Mass [Solar mass]|Stellar Luminosity [log(Solar)]|Stellar Surface Gravity [log10(cm/s**2)]|Stellar Age [Gyr]\n",
+ "---|---|---|---|---|---|---|---\n",
+ "11 Com|G8III|4874.00|13.76|2.09|1.978|2.45|\n",
+ "11 UMi|K4III|4213.00|29.79|2.78|2.430|1.93|1.560\n",
+ "14 And|K0III|4888.00|11.55|1.78|1.840|2.55|4.500\n",
+ "\n",
+ "As you might have already guessed, this file contains data on a number of *stars* outside our solar system along with some important statistics about these stars. The columns here are as follows:\n",
+ "\n",
+ "- `Star Name`: The **name** given to the star by the *International Astronomical Union*,\n",
+ "- `Spectral Type`: The **Spectral Classification** of the star as per the *Morgan–Keenan (MK) system*,\n",
+ "- `Stellar Effective Temperature [K]`: The **temperature** of a *black body* (in units of Kelvin) that would emit the *observed radiation* of the star,\n",
+ "- `Stellar Radius [Solar Radius]`: The **radius** of the star (in units of the radius of the Sun),\n",
+ "- `Stellar Mass [Solar mass]`: The **mass** of the star (in units of the mass of the Sun),\n",
+ "- `Stellar Luminosity [log(Solar)]`: The *total* amount of **energy radiated** by the star **each second** (represented by the logarithm of the energy radiated by the Sun in each second),\n",
+ "- `Stellar Surface Gravity [log10(cm/s**2)]`: The **acceleration due to the gravity** of the Star at its *surface* (represented by the logarithm of the acceleration measured in centimeter per second squared),\n",
+ "- `Stellar Age [Gyr]`: The total **age** of the star (in units of Giga years, i.e., billions of years).\n",
+ "\n",
+ "The four other files `stars_2.csv`, `stars_3.csv`, `stars_4.csv`, and `stars_5.csv` also store similar data in the same format. At this stage of the project, it is alright if you do not understand what these columns mean - they will be explained to you when they become necessary (in P11)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8f15162c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "On the other hand, here are the first three rows of the file `planets_1.csv`:\n",
+ "\n",
+ "Planet Name|Discovery Method|Discovery Year|Controversial Flag|Orbital Period [days]|Planet Radius [Earth Radius]|Planet Mass [Earth Mass]|Orbit Semi-Major Axis [au]|Eccentricity|Equilibrium Temperature [K]|Insolation Flux [Earth Flux]\n",
+ "---|---|---|---|---|---|---|---|---|---|---\n",
+ "11 Com b|Radial Velocity|2007|0|323.21000000|12.200|4914.89849|1.178000|0.238000||\n",
+ "11 UMi b|Radial Velocity|2009|0|516.21997000|12.300|4684.81420|1.530000|0.080000||\n",
+ "14 And b|Radial Velocity|2008|0|186.76000000|13.100|1131.15130|0.775000|0.000000||\n",
+ "\n",
+ "This file contains data on a number of *planets* outside our solar system along with some important statistics about these planets. The columns here are as follows:\n",
+ "\n",
+ "- `Planet Name`: The **name** given to the planet by the *International Astronomical Union*,\n",
+ "- `Discovery Method`: The **method** by which the planet was *discovered*,\n",
+ "- `Discovery Year`: The **year** in which the planet was *discovered*,\n",
+ "- `Controversial Flag`: Indicates whether the status of the discovered object as a planet was **disputed** at the time of discovery, \n",
+ "- `Orbital Period [days]`: The amount of **time** (in units of days) it takes for the planet to **complete one orbit** around its star,\n",
+ "- `Planet Radius [Earth Radius]`: The **radius** of the planet (in units of the radius of the Earth),\n",
+ "- `Planet Mass [Earth Mass]`: The **mass** of the planet (in units of the mass of the Earth),\n",
+ "- `Orbit Semi-Major Axis [au]`: The **semi-major axis** of the planet's elliptical **orbit** around its host star (in units of Astronomical Units),\n",
+ "- `Eccentricity`: The **eccentricity** of the planet's orbit around its host star,\n",
+ "- `Equilibrium Temperature [K]`: The **temperature** of the planet (in units of Kelvin) if it were a *black body* heated only by its host star,\n",
+ "- `Insolation Flux [Earth Flux]`: The amount of **radiation** the planet received from its host star **per unit of area** (in units of the Insolation Flux of the Earth from the Sun).\n",
+ "\n",
+ "The four other files `planets_2.csv`, `planets_3.csv`, `planets_4.csv`, and `planets_5.csv` also store similar data in the same format. At this stage of the project, it is alright if you do not understand what these columns mean - they will be explained to you when they become necessary (in P11)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "993dc38e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "Finally, if you take a look at `mapping_1.json` (you can open json files using any Text Editor), you will see that the first three entries look like this:\n",
+ "\n",
+ "```python\n",
+ "{\"11 Com b\":\"11 Com\",\"11 UMi b\":\"11 UMi\",\"14 And b\":\"14 And\", ...}\n",
+ "```\n",
+ "\n",
+ "This file contains a *mapping* from each *planet* in `planets_1.csv` to the *star* in `stars_1.csv` that the planet orbits. Similarly, `mapping_2.json` contains a *mapping* from each *planet* in `planets_2.csv` to the *star* in `stars_2.csv` that the planet orbits. The pattern also holds true for `mapping_3.json`, `mapping_4.json`, and `mapping_5.json`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "dc1c070e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Project Requirements:\n",
+ "\n",
+ "You **may not** hardcode indices in your code, unless the question explicitly says to. If you open your `.csv` files with Excel, manually count through the rows and use this number to loop through the dataset, this is also considered as hardcoding. If any instances of hardcoding are found during code review, the Gradescope autograder will **deduct** points from your public score.\n",
+ "\n",
+ "**Store** your final answer for each question in the **variable specified for each question**. This step is important because Otter grades your work by comparing the value of this variable against the correct answer.\n",
+ "\n",
+ "For some of the questions, we'll ask you to write (then use) a function to compute the answer. If you compute the answer **without** creating the function we ask you to write, the Gradescope autograder will **deduct** points from your public score, even if the way you did it produced the correct answer.\n",
+ "\n",
+ "#### Required Functions:\n",
+ "- `star_cell`\n",
+ "- `get_stars`\n",
+ "- `planet_cell`\n",
+ "- `get_planets`\n",
+ "\n",
+ "In this project, you will also be required to define certain **data structures**. If you do not create these data structures exactly as specified, the Gradescope autograder will **deduct** points from your public score, even if the way you did it produced the correct answer.\n",
+ "\n",
+ "#### Required Data Structures:\n",
+ "- `Star` (**namedtuple**)\n",
+ "- `stars_dict` (**dictionary** mapping **strings** to `Star` objects)\n",
+ "- `Planet` (**namedtuple**)\n",
+ "- `planets_list` (**list** of `Planet` objects)\n",
+ "\n",
+ "In addition, you are also **required** to follow the requirements below:\n",
+ "\n",
+ "* You **must** never use the output of the `os.listdir` function directly. You **must** always first remove all files and directories that start with `\".\"`, and **explicitly sort** the list before doing anything with it.\n",
+ "* You are **not** allowed to use **bare** `try/except` blocks. In other words, you can **not** use `try/except` without explicitly specifying the type of exceptions that you want to catch.\n",
+ "* You are **only** allowed to use Python commands and concepts that have been taught in the course prior to the release of P10. In particular, this means that you are **not** allowed to use **modules** like `pandas` to answer the questions in this project.\n",
+ "* Please do not display `start_dict` or `planets_list` anywhere in the notebook. Please **remove** such statements before submission.\n",
+ "\n",
+ "Otherwise, the Gradescope autograder will **deduct** points from your public score.\n",
+ "\n",
+ "For more details on what will cause you to lose points during code review and specific requirements, please take a look at the [Grading rubric](https://git.doit.wisc.edu/cdis/cs/courses/cs220/cs220-f23-projects/-/blob/main/p10/rubric.md)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "f9ab5264",
+ "metadata": {
+ "deletable": false,
+ "editable": false,
+ "lines_to_next_cell": 0
+ },
+ "source": [
+ "## Questions and Functions:\n",
+ "\n",
+ "Let us start by importing all the modules we will need for this project."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "642e0e3f",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.542135Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.542135Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.549457Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.548457Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# it is considered a good coding practice to place all import statements at the top of the notebook\n",
+ "# please place all your import statements in this cell if you need to import any more modules for this project\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c3b886f6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### File handling:\n",
+ "\n",
+ "In the next questions, you will be using functions in the `os` module to make **lists** of files and paths in the `data` directory. All your **lists** **must** satisfy the following conditions:\n",
+ "\n",
+ "* Any files with names beginning with `\".\"` **must** be **excluded**.\n",
+ "* The list **must** be in **reverse-alphabetical** order."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8231ac15",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 1:** What are the **names** of the files present in the `data` directory\n",
+ "\n",
+ "Your output **must** be a **list** of **strings** representing the **names** of the files."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "b4fdd3cd",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.555460Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.554460Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.569113Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.568116Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'files_in_data', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "91285c22",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q1\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e655661c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 2:** What are the **paths** of all the files in the `data` directory?\n",
+ "\n",
+ "Your output **must** be a **list** of **strings** representing the **paths** of the files. You **must** use the `files_in_data` variable created in the previous question to answer this.\n",
+ "\n",
+ "**Warning:** Please **do not hardcode** `\"/\"` or `\"\\\"` in your path because doing so will cause your function to **fail** on a computer that's not using the same operating system as yours. This may result in your code failing on Gradescope."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "ce9c72a6",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.625763Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.624766Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.635822Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.634827Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'file_paths', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "147e69c2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q2\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2dd99aea",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 3:** What are the **paths** of all the **CSV files** present in `data` directory?\n",
+ "\n",
+ "Your output **must** be filtered to **only** include files ending in `'.csv'`. You **must** use either the `files_in_data` or `file_paths` variables created in the previous questions to answer this.\n",
+ "\n",
+ "**Warning:** Please **do not hardcode** `\"/\"` or `\"\\\"` in your path because doing so will cause your function to **fail** on a computer that's not using the same operating system as yours. This may result in your code failing on Gradescope."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "99fd56f7",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.706074Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.705074Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.716793Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.715800Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'csv_file_paths', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e411d77f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q3\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "999aa8d2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 4:** What are the **paths** of all the files present in `data` directory, that **begin** with the phrase `'stars'`?\n",
+ "\n",
+ "Your output **must** be filtered to **only** include files start with `'stars'`. You **must** use either the `files_in_data` or `file_paths` variables created in the previous questions to answer this.\n",
+ "\n",
+ "**Warning:** Please **do not hardcode** `\"/\"` or `\"\\\"` in your path because doing so will cause your function to **fail** on a computer that's not using the same operating system as yours. This may result in your code failing on Gradescope."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "fba07316",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.793042Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.793042Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.802270Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.801277Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'stars_paths', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1c033025",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q4\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "549ef1f9",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 1: namedtuple `Star`\n",
+ "\n",
+ "You will be using named tuples to store the data in the `stars_1.csv`, ..., `stars_5.csv` files. Before you start reading these files however, you **must** create a new `Star` type (using namedtuple). It **must** have the following attributes:\n",
+ "\n",
+ "* `spectral_type`,\n",
+ "* `stellar_effective_temperature`,\n",
+ "* `stellar_radius`,\n",
+ "* `stellar_mass`,\n",
+ "* `stellar_luminosity`,\n",
+ "* `stellar_surface_gravity`,\n",
+ "* `stellar_age`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1b4d2a53",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.881127Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.880127Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.887847Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.886853Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the namedtuple 'Star' here\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "b18fa0d1",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.892849Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.892849Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.902087Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.901101Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# run this following cell to initialize and test an example Star object\n",
+ "# if this cell fails to execute, you have likely not defined the namedtuple 'Star' correctly\n",
+ "\n",
+ "sun = Star('G2 V', 5780.0, 1.0, 1.0, 0.0, 4.44, 4.6)\n",
+ "\n",
+ "sun"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "71991699",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"Star\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "10544951",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Creating `Star` objects\n",
+ "\n",
+ "Now that we have created the `Star` namedtuple, our next objective will be to read the files `stars_1.csv`, ..., `stars_5.csv` and create `Star` objects out of all the stars in there. In order to process the CSV files, you will first need to copy/paste the `process_csv` function you have been using since P6."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "75e8b09f",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.947045Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.947045Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.954045Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.953043Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# copy & paste the process_csv file from previous projects here\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5dfab81c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "You are now ready to read the data in `stars_1.csv` using `process_csv` and convert the data into `Star` objects. In the cell below, you **must** read the data in `stars_1.csv` and extract the **header** and the non-header **rows** of the file."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "0322bf85",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.959042Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.958042Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.969595Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.968600Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "stars_1_csv = ... # read the data in 'stars_1.csv'\n",
+ "stars_header = ...\n",
+ "stars_1_rows = ..."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3ecbd66c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the file and defined the variables correctly, you can check that `stars_header` has the value:\n",
+ "\n",
+ "```python\n",
+ "['Star Name', 'Spectral Type', 'Stellar Effective Temperature [K]', 'Stellar Radius [Solar Radius]',\n",
+ " 'Stellar Mass [Solar mass]', 'Stellar Luminosity [log(Solar)]', \n",
+ " 'Stellar Surface Gravity [log10(cm/s**2)]', 'Stellar Age [Gyr]']\n",
+ "```\n",
+ "\n",
+ "and that `stars_1_rows` has **1595** rows of which the **first three** are:\n",
+ "\n",
+ "```python\n",
+ "[['11 Com', 'G8III', '4874.00', '13.76', '2.09', '1.978', '2.45', ''],\n",
+ " ['11 UMi', 'K4III', '4213.00', '29.79', '2.78', '2.430', '1.93', '1.560'],\n",
+ " ['14 And', 'K0III', '4888.00', '11.55', '1.78', '1.840', '2.55', '4.500']]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1b5d0bcf",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 1: `star_cell(row_idx, col_name, stars_rows, header=stars_header)`\n",
+ "\n",
+ "This function **must** read the **list** of **lists** `stars_rows`, and extract the value at **row** index `row_idx` and **column** index `col_idx`. The function **must** typecast the value based on `col_name`. If the value in `stars_rows` is **missing** (i.e., it is `''`), then the value returned **must** be `None`.\n",
+ "\n",
+ "The **column** of `stars_rows` where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Column of `stars_rows`|Data Type|\n",
+ "|------|---------|\n",
+ "|Star Name|**string**|\n",
+ "|Spectral Type|**string**|\n",
+ "|Stellar Effective Temperature [K]|**float**|\n",
+ "|Stellar Radius [Solar Radius]|**float**|\n",
+ "|Stellar Mass [Solar mass]|**float**|\n",
+ "|Stellar Luminosity [log(Solar)]|**float**|\n",
+ "|Stellar Surface Gravity [log10(cm/s**2)]|**float**|\n",
+ "|Stellar Age [Gyr]|**float**|\n",
+ "\n",
+ "You are **allowed** to copy/paste this function from Lab-P10."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "061ef7fd",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:26.975601Z",
+ "iopub.status.busy": "2023-11-08T00:40:26.974597Z",
+ "iopub.status.idle": "2023-11-08T00:40:26.989939Z",
+ "shell.execute_reply": "2023-11-08T00:40:26.988940Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the 'star_cell' function here\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "4372c4e9",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"star_cell\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b020cfb8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 5:** Create a `Star` object for the **third** star in `\"stars_1.csv\"`.\n",
+ "\n",
+ "You **must** access the values in `stars_1.csv` using the `star_cell` function. Note that the third star would be at **index** 2.\n",
+ "\n",
+ "The **attribute** of the `Star` namedtuple object, the corresponding **column** of the `stars_1.csv` file where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Attribute of `Star` object|Column of `stars_1.csv`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`spectral_type`|Spectral Type|**string**|\n",
+ "|`stellar_effective_temperature`|Stellar Effective Temperature [K]|**float**|\n",
+ "|`stellar_radius`|Stellar Radius [Solar Radius]|**float**|\n",
+ "|`stellar_mass`|Stellar Mass [Solar mass]|**float**|\n",
+ "|`stellar_luminosity`|Stellar Luminosity [log(Solar)]|**float**|\n",
+ "|`stellar_surface_gravity`|Stellar Surface Gravity [log10(cm/s**2)]|**float**|\n",
+ "|`stellar_age`|Stellar Age [Gyr]|**float**|"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "01a1bea0",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.047893Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.046892Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.060487Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.059488Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ " # compute and store the answer in the variable 'third_star', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2f7717a8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q5\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bf286c95",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 2: `get_stars(star_file)`\n",
+ "\n",
+ "This function **must** take in as its input, the path of a CSV file `star_file` which contains data on stars in the same format as `stars_1.csv`. It **must** return a **dictionary** mapping the `Name` of each star in `star_file` to a `Star` object containing all the other details of the star.\n",
+ "\n",
+ "You **must** access the values in `stars_file` using the `star_cell` function.\n",
+ "\n",
+ "You **must not** hardcode the name of the directory `data` into the `get_stars` function. Instead, you must pass it as a part of the argument `star_file`, by including it in the **path** `star_file`.\n",
+ "\n",
+ "Once again, as a reminder, the attributes of the `Star` objects should be obtained from the **rows** of `star_file` and stored as follows:\n",
+ "\n",
+ "|Attribute of `Star` object|Column of `star_file`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`spectral_type`|Spectral Type|**string**|\n",
+ "|`stellar_effective_temperature`|Stellar Effective Temperature [K]|**float**|\n",
+ "|`stellar_radius`|Stellar Radius [Solar Radius]|**float**|\n",
+ "|`stellar_mass`|Stellar Mass [Solar mass]|**float**|\n",
+ "|`stellar_luminosity`|Stellar Luminosity [log(Solar)]|**float**|\n",
+ "|`stellar_surface_gravity`|Stellar Surface Gravity [log10(cm/s**2)]|**float**|\n",
+ "|`stellar_age`|Stellar Age [Gyr]|**float**|\n",
+ "\n",
+ "In case any data in `star_file` is **missing**, the corresponding value should be `None`.\n",
+ "\n",
+ "For example, when this function is called with the file `stars_1.csv` as the input, the **dictionary** returned should look like:\n",
+ "\n",
+ "```python\n",
+ "{'11 Com': Star(spectral_type='G8III', stellar_effective_temperature=4874.0, \n",
+ " stellar_radius=13.76, stellar_mass=2.09, stellar_luminosity=1.978, \n",
+ " stellar_surface_gravity=2.45, stellar_age=None),\n",
+ " '11 UMi': Star(spectral_type='K4III', stellar_effective_temperature=4213.0, \n",
+ " tellar_radius=29.79, stellar_mass=2.78, stellar_luminosity=2.43, \n",
+ " stellar_surface_gravity=1.93, stellar_age=1.56),\n",
+ " '14 And': Star(spectral_type='K0III', stellar_effective_temperature=4888.0, \n",
+ " stellar_radius=11.55, stellar_mass=1.78, stellar_luminosity=1.84, \n",
+ " stellar_surface_gravity=2.55, stellar_age=4.5),\n",
+ " ...\n",
+ "}\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "790d24b9",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.117359Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.116361Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.125880Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.124887Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the function 'get_stars' here\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "ac87e0b3",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.131886Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.131886Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.160604Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.159607Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# you can now use 'get_stars' to read the data in 'stars_1.csv'\n",
+ "\n",
+ "stars_1_dict = ..."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "45d3b8b5",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"get_stars\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a85665e7",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 6:** What is the `Star` object of the star (in `stars_1.csv`) named *DP Leo*?\n",
+ "\n",
+ "You **must** access the `Star` object in `stars_1_dict` **dictionary** defined above to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2b4e1b03",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.229789Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.228786Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.237757Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.236758Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'dp_leo', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5a9c1aea",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q6\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e7445786",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 7:** What's the **average** `stellar_luminosity` of **all** the stars in the `star_1.csv` file?\n",
+ "\n",
+ "You **must** use the `stars_1_dict` **dictionary** defined above to answer this question.\n",
+ "\n",
+ "To find the average, you **must** first **add** up the `stellar_luminosity` value of all the stars and **divide** by the total **number** of stars. You **must skip** stars which don't have the `stellar_luminosity` data. Such stars should not contribute to either the sum of `stellar_luminosity` or to the number of stars."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3037793e",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.270482Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.270482Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.281432Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.280437Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'avg_lum_stars_1', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8552446f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q7\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "dfb9bb43",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 8:** What is the **average** `stellar_age` of **all** the stars in the `stars_2.csv` file?\n",
+ "\n",
+ "You **must** use the function `get_stars(csv_file)` to read the data in `stars_2.csv`. Your output **must** be a **float** representing the `stellar_age` in units of *gigayears*. You **must** skip stars which have missing `stellar_age` data."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f72168eb",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.338156Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.338156Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.364161Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.363160Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'avg_age_stars_2', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "62d0a888",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q8\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9c119a33",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 2: `stars_dict`\n",
+ "\n",
+ "You are now ready to read all the data about the stars stored in the `data` directory. You **must** now create a **dictionary** mapping the `Name` of each star in the `data` directory (inside the files `stars_1.csv`, ..., `stars_5.csv`) to the `Star` object containing all the other details about the star.\n",
+ "\n",
+ "You **must not** hardcode the files/paths of the files `stars_1.csv`, ..., `stars_5.csv` to answer this question. Instead, you **must** use the `stars_paths` variable defined earlier in Question 4 to get the list of paths needed for this question. You can use the `update` dictionary **method** to combine two **dictionaries**.\n",
+ "\n",
+ "You must use this dictionary to answer the next 3 questions."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5163f940",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.419123Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.419123Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.485650Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.484740Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the variable 'stars_dict' here,\n",
+ "# but do NOT display the variable at the end\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "54e0c241",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"stars_dict\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9c7d67a9",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the files and defined `stars_dict` correctly, you can check that `stars_dict` has **4125** key/value pairs in it."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "65b3495f",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 9:** What is the `stellar_effective_temperature` of the star *Kepler-220*?\n",
+ "\n",
+ "You **must** access the correct `Star` object in the `stars_dict` **dictionary** defined above to answer this question."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d3c864f9",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.530823Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.529824Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.539550Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.538554Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'kepler_220_temp', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6ac67a10",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q9\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "18eeb1f7",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 10:** Find the **name** of the **largest** star (in terms of `stellar_radius`) in the `data` directory.\n",
+ "\n",
+ "Your output **must** be a **string**. You do **not** need to worry about any ties. You **must** skip any stars with **missing** `stellar_radius` data."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e78df115",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.576572Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.575574Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.593114Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.592117Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'biggest_star', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "0701f05c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q10\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "c3b412e1",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 11:** What is the **average** `stellar_age` (in gigayears) of **all** the stars in the `data` directory whose names **start with** `\"Kepler\"`?\n",
+ "\n",
+ "Your output **must** be a **float**. You **must** skip all stars with **missing** `stellar_age` data. Such stars should not contribute to either the sum of `stellar_age` or to the number of stars."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "e6ff1322",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.659767Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.658768Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.678765Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.677766Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'avg_age_kepler', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "776dd2ec",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q11\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "228d1c3a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 3: namedtuple `Planet`\n",
+ "\n",
+ "Just as you did with the stars, you will be using named tuples to store the data about the planets in the `planets_1.csv`, ..., `planets_5.csv` files. Before you start reading these files however, you **must** create a new `Planet` type (using namedtuple). It **must** have the following attributes:\n",
+ "\n",
+ "* `planet_name`,\n",
+ "* `host_name`,\n",
+ "* `discovery_method`,\n",
+ "* `discovery_year`,\n",
+ "* `controversial_flag`,\n",
+ "* `orbital_period`,\n",
+ "* `planet_radius`,\n",
+ "* `planet_mass`,\n",
+ "* `semi_major_radius`,\n",
+ "* `eccentricity`,\n",
+ "* `equilibrium_temperature`\n",
+ "* `insolation_flux`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "773ac3c0",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.750830Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.750830Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.759039Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.758043Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the namedtuple 'Planet' here\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "c627718c",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.766036Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.765038Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.777391Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.776395Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# run this following cell to initialize and test an example Planet object\n",
+ "# if this cell fails to execute, you have likely not defined the namedtuple 'Planet' correctly\n",
+ "jupiter = Planet('Jupiter', 'Sun', 'Imaging', 1610, False, 4333.0, 11.209, 317.828, 5.2038, 0.0489, 110, 0.0345)\n",
+ "\n",
+ "jupiter"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "39bb10d2",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"Planet\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5fd25e40",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Creating `Planet` objects\n",
+ "\n",
+ "We are now ready to read the files in the `data` directory and create `Planet` objects. Creating `Planet` objects however, is going to be more difficult than creating `Star` objects, because the data required to create a single `Planet` object is split up into different files.\n",
+ "\n",
+ "The `planets_1.csv`, ..., `planets_5.csv` files contain all the data required to create `Planet` objects **except** for the `host_name`. The `host_name` for each planet is to be found in the `mapping_1.json`, ..., `mapping_5.json` files."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a6efc51a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "First, let us read the data in `planets_1.csv`. Since this is a CSV file, you can use the `process_csv` function from above to read this file. In the cell below, you **must** read the data in `planets_1.csv` and extract the **header** and the non-header **rows** of the file."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "bf3dfea9",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.827079Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.826079Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.839724Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.838726Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# replace the ... with your code\n",
+ "\n",
+ "planets_1_csv = process_csv(...) # read the data in 'planets_1.csv'\n",
+ "planets_header = ...\n",
+ "planets_1_rows = ..."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "dd3228eb",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the file and defined the variables correctly, you can check that `planets_header` has the value:\n",
+ "\n",
+ "```python\n",
+ "['Planet Name', 'Discovery Method', 'Discovery Year', 'Controversial Flag',\n",
+ " 'Orbital Period [days]', 'Planet Radius [Earth Radius]', 'Planet Mass [Earth Mass]',\n",
+ " 'Orbit Semi-Major Axis [au]', 'Eccentricity', 'Equilibrium Temperature [K]',\n",
+ " 'Insolation Flux [Earth Flux]']\n",
+ "```\n",
+ "\n",
+ "and that `planets_1_rows` has **1595** rows of which the **first three** are:\n",
+ "\n",
+ "```python\n",
+ "[['11 Com b', 'Radial Velocity', '2007', '0', '323.21000000', '12.200', '4914.89849', '1.178000', '0.238000', '', ''],\n",
+ " ['11 UMi b', 'Radial Velocity', '2009', '0', '516.21997000', '12.300', '4684.81420', '1.530000', '0.080000', '', ''],\n",
+ " ['14 And b', 'Radial Velocity', '2008', '0', '186.76000000', '13.100', '1131.15130', '0.775000', '0.000000', '', '']]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "82a7a93e",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "Now, you are ready to read the data in `mapping_1.json`. Since this is a JSON file, you will need to copy/paste the `read_json` function Lab-P10, and use it to read the file."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "20f97e3e",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.846718Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.845719Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.853722Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.852720Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# copy & paste the read_json file from Lab-P10\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "da23f5bd",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.859721Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.858723Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.868608Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.867612Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# now use the read_json function to read 'mapping_1.json'\n",
+ "\n",
+ "mapping_1_json = ..."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "104f741a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the file correctly, you can check that `mapping_1_json` has the value:\n",
+ "\n",
+ "```python\n",
+ "{'11 Com b': '11 Com',\n",
+ " '11 UMi b': '11 UMi',\n",
+ " '14 And b': '14 And',\n",
+ " ...\n",
+ " }\n",
+ "```\n",
+ "\n",
+ "Now that we have read `planets_1.csv` and `mapping_1.json`, we are now ready to combine these two files to create `Planet` objects."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "1d011f1b",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 3: `planet_cell(row_idx, col_name, planets_rows, header=planets_header)`\n",
+ "\n",
+ "This function **must** read the **list** of **lists** `planets_rows`, and extract the value at **row** index `row_idx` and **column** index `col_idx`. The function **must** typecast the value based on `col_name`. If the value in `planets_rows` is **missing** (i.e., it is `''`), then the value returned **must** be `None`.\n",
+ "\n",
+ "The **column** of `planets_rows` where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Column of `planets_rows`|Data Type|\n",
+ "|------|---------|\n",
+ "|Planet Name|**string**|\n",
+ "|Discovery Year|**int**|\n",
+ "|Discovery Method|**string**|\n",
+ "|Controversial Flag|**bool**|\n",
+ "|Orbital Period [days]|**float**|\n",
+ "|Planet Radius [Earth Radius]|**float**|\n",
+ "|Planet Mass [Earth Mass]|**float**|\n",
+ "|Orbit Semi-Major Axis [au]|**float**|\n",
+ "|Eccentricity|**float**|\n",
+ "|Equilibrium Temperature [K]|**float**|\n",
+ "|Insolation Flux [Earth Flux]|**float**|\n",
+ "\n",
+ "**Important Hint:** While computing the value of the attribute `controversial_flag`, note that the `Controversial Flag` column of `planets_1.csv` represents `True` with `'1'` and `False` with `'0'`. You **must** be careful with typecasting **strings** to **booleans**."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "fb509f13",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.875610Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.874611Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.898015Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.897021Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the function 'planet_cell' here\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d21d187c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"planet_cell\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "10cdb778",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 12:** Create a `Planet` object for the **fifth** planet in the `planets_1.csv` file.\n",
+ "\n",
+ "You **must** access the values in `planets_1.csv` using the `planet_cell` function. Note that the fifth planet would be at **index** 4.\n",
+ "\n",
+ "The **attribute** of the `Planet` namedtuple object, the corresponding **column** of the `planets_1.csv` file where the value should be obtained from, and the correct **data type** for the value are listed in the table below:\n",
+ "\n",
+ "|Attribute of `Planet` object|Column of `planets_1.csv`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`planet_name`|Planet Name|**string**|\n",
+ "|`host_name`| - |**string**|\n",
+ "|`discovery_method`|Discovery Method|**string**|\n",
+ "|`discovery_year`|Discovery Year|**int**|\n",
+ "|`controversial_flag`|Controversial Flag|**bool**|\n",
+ "|`orbital_period`|Orbital Period [days]|**float**|\n",
+ "|`planet_radius`|Planet Radius [Earth Radius]|**float**|\n",
+ "|`planet_mass`|Planet Mass [Earth Mass]|**float**|\n",
+ "|`semi_major_radius`|Orbit Semi-Major Axis [au]|**float**|\n",
+ "|`eccentricity`|Eccentricity|**float**|\n",
+ "|`equilibrium_temperature`|Equilibrium Temperature [K]|**float**|\n",
+ "|`insolation_flux`|Insolation Flux [Earth Flux]|**float**|\n",
+ "\n",
+ "\n",
+ "The value of the `host_name` attribute is found in `mapping_1.json`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "747a47bf",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:27.966668Z",
+ "iopub.status.busy": "2023-11-08T00:40:27.966668Z",
+ "iopub.status.idle": "2023-11-08T00:40:27.982081Z",
+ "shell.execute_reply": "2023-11-08T00:40:27.981089Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'fifth_planet', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "3913c49a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q12\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d2e1e4c4",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Function 4: `get_planets(planet_file, mapping_file)`: \n",
+ "\n",
+ "This function **must** take in as its input, a CSV file `planet_file` which contains data on planets in the same format as `planets_1.csv`, as well as a JSON file `mapping_file` which maps planets in `planet_file` to their host star in the same format as `mapping_1.json`. This function **must** return a **list** of `Planet` objects by combining the data in these two files. The `Planet` objects **must** appear in the same order as they do in `planet_file`.\n",
+ "\n",
+ "You **must** access the values in `planets_file` using the `planet_cell` function.\n",
+ "\n",
+ "You **must not** hardcode the name of the directory `data` into the `get_planets` function. Instead, you must pass it as a part of the arguments `planet_file` and `mapping_file`.\n",
+ "\n",
+ "Once again, as a reminder, the attributes of the `Planet` objects should be obtained from the **rows** of `planet_file` and from `mapping_file` and stored as follows:\n",
+ "\n",
+ "|Attribute of `Planet` object|Column of `planets_1.csv`|Data Type|\n",
+ "|---------|------|---------|\n",
+ "|`planet_name`|Planet Name|**string**|\n",
+ "|`host_name`| - |**string**|\n",
+ "|`discovery_method`|Discovery Method|**string**|\n",
+ "|`discovery_year`|Discovery Year|**int**|\n",
+ "|`controversial_flag`|Controversial Flag|**bool**|\n",
+ "|`orbital_period`|Orbital Period [days]|**float**|\n",
+ "|`planet_radius`|Planet Radius [Earth Radius]|**float**|\n",
+ "|`planet_mass`|Planet Mass [Earth Mass]|**float**|\n",
+ "|`semi_major_radius`|Orbit Semi-Major Axis [au]|**float**|\n",
+ "|`eccentricity`|Eccentricity|**float**|\n",
+ "|`equilibrium_temperature`|Equilibrium Temperature [K]|**float**|\n",
+ "|`insolation_flux`|Insolation Flux [Earth Flux]|**float**|\n",
+ "\n",
+ "The value of the `host_name` attribute is found in `mapping_file`.\n",
+ "\n",
+ "In case any data in `planet_file` is **missing**, the corresponding value should be `None`.\n",
+ "\n",
+ "For example, when this function is called with the file `planets_1.csv` and `mapping_1.json` as the input, the **list** returned should look like:\n",
+ "\n",
+ "```python\n",
+ "[ Planet(planet_name='11 Com b', host_name='11 Com', discovery_method='Radial Velocity', discovery_year=2007, controversial_flag=False, orbital_period=323.21, planet_radius=12.2, planet_mass=4914.89849, semi_major_radius=1.178, eccentricity=0.238, equilibrium_temperature=None, insolation_flux=None),\n",
+ " Planet(planet_name='11 UMi b', host_name='11 UMi', discovery_method='Radial Velocity', discovery_year=2009, controversial_flag=False, orbital_period=516.21997, planet_radius=12.3, planet_mass=4684.8142, semi_major_radius=1.53, eccentricity=0.08, equilibrium_temperature=None, insolation_flux=None),\n",
+ " ...]\n",
+ "```"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "dfcc3c07",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.048786Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.047786Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.061560Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.060557Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "def get_planets(planet_file, mapping_file):\n",
+ " # TODO: read planet_file to a list of lists\n",
+ " # TODO: extract the header and rows from planet_file\n",
+ " # TODO: read mapping_file to a dictionary\n",
+ " # TODO: loop through each row in planet_file with indices\n",
+ " # TODO: create a Planet object (namedTuple) for each row\n",
+ " # TODO: add each Planet objet to a list\n",
+ " # TODO: return the list after the end of the loop\n",
+ " pass # replace with your code"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "73bbe253",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"get_planets\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3b1bc76c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 13:** What are the **last five** `Planet` objects in the **list** returned by `get_planets` when `planet_file` is `planets_1.csv` and `mapping_file` is `mapping_1.json`?\n",
+ "\n",
+ "Your output **must** be a **list** of `Planet` objects.\n",
+ "\n",
+ "**Hint:** First, you **must** use the `get_planets` function to parse the data in `planets_1.csv` and `mapping_1.json` and create a **list** of `Planet` objects. Then, you may slice this **list** to get the last five `Planet` objects."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2eb1f3e2",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.126931Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.125924Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.168019Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.167014Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'last_five_planets_1', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5f15a9e1",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q13\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4044de21",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 14:** What are the `Planet` objects whose `controversial_flag` attribute is `True` in the **list** returned by `get_planets` when `planet_file` is `planets_2.csv` and `mapping_file` is `mapping_2.json`?\n",
+ "\n",
+ "Your output **must** be a **list** of `Planet` objects."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "5f21af9a",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.222608Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.221608Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.259628Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.258636Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'controversial_planets', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "6e60a562",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q14\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "aa3b6fe3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Cleaning 1: Broken CSV rows\n",
+ "\n",
+ "Our function `get_planets` works very well so far. However, it is likely that it will not work on all the files in the `data` directory. For example, if you use the function `get_planets` to read the data in `planets_4.csv` and `mapping_4.json`, you will most likely run into an error. **Try it yourself to verify!**\n",
+ "\n",
+ "The reason your code likely crashed is because there the file `planets_4.csv` is **broken**. For some reason, several rows in `planets_4.csv` have their data jumbled up. For example, in the **seventh** row of `planets_4.csv`, we come across this row:\n",
+ "\n",
+ "|Planet Name|Discovery Method|Discovery Year|Controversial Flag|Orbital Period [days]|Planet Radius [Earth Radius]|Planet Mass [Earth Mass]|Orbit Semi-Major Axis [au]|Eccentricity|Equilibrium Temperature [K]|Insolation Flux [Earth Flux]|\n",
+ "|-----------|----------------|--------------|------------------|---------------------|----------------------------|------------------------|---------------------------|------------|---------------------------|----------------------------|\n",
+ "123.01000000|Radial Velocity|2009|0|61 Vir d|5.110|22.90000|0.476000|0.350000||\n",
+ "\n",
+ "We can see that for some reason, the value under the column `Planet Name` is a **number** while the value under the column `Orbital Period [days]` is a **string**. It is possible that these two columns of data got *swapped* here, but we cannot be sure about this.\n",
+ "\n",
+ "We will call such a **row** in a CSV file where the values under a column do not match the expected format to be a **broken row**. While it is possible to sometimes extract useful data from broken rows, in this project, we will simply **skip** broken rows.\n",
+ "\n",
+ "You **must** now go back to your definition of `get_planets` and edit it, so that any **broken rows get skipped**.\n",
+ "\n",
+ "**Hints:**\n",
+ "\n",
+ "1. The simplest way to recognize if a row is broken is if you run into any **RunTime Errors** when you call the `get_planets` function. So, one simple way to skip bad rows would be to use `try/except` blocks to avoid processing any rows that cause the code to crash; remember **not** to use *bare* `try/except` blocks.\n",
+ "2. There are only **10** broken rows in `planets_4.csv`, and they are all **bunched up** at the very beginning and the very end of the dataset. You can manually **inspect** the **first 10 and last 10** rows, and figure out which of these rows are broken and why.\n",
+ "\n",
+ "**Important Warning:** You are **not** allowed to **hardcode** the indices of the broken rows. You may inspect `planets_4.csv` to identify how to tell a **broken row** apart. Therefore, to use the example of the **broken row** above, you **may not** hardcode to skip the **seventh** row of `planets_4.csv`. However, it is **acceptable** to make your function **skip** any row for which the value under the `Planet Name` is not numeric, by observing that this is the reason why the row is broken."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "cb894a51",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 15:** What are the **last five** `Planet` objects produced by `get_planets` when `planet_file` is `planets_4.csv` and `mapping_file` is `mapping_4.json`?\n",
+ "\n",
+ "Your output **must** be a **list** of `Planet` objects."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "026ee35d",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.322148Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.321149Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.341311Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.340368Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'last_five_planets_4', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "34314589",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q15\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9f551f15",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Cleaning 2: Broken JSON files\n",
+ "\n",
+ "We are now ready to read **all** the files in the `data` directory and create a **list** of `Planet` objects for all the planets in the directory. However, if you try to use `get_planets` on all the planet CSV files and mapping JSON files, you will likely run into another error. **Try it for yourself by calling `get_planets` on all the files in `data`!**\n",
+ "\n",
+ "It is likely that your code crashed when you tried to read the data in `planets_5.csv` and `mapping_5.json`. This is because the file `mapping_5.json` is **broken**. Unlike **broken** CSV files, where we only had to skip the **broken rows**, it is much harder to parse **broken JSON files**. When a JSON file is **broken**, we often have no choice but to **skip the file entirely**.\n",
+ "\n",
+ "You **must** now go back to your definition of `get_planets` and edit it, so that if the JSON file is **broken**, then the file is completely skipped, and only an **empty list** is returned.\n",
+ "\n",
+ "**Important Warning:** You are **not** allowed to **hardcode** the name of the files to be skipped. You **must** use `try/except` blocks to determine whether the JSON file is **broken** and skip the file if it is.\n",
+ "\n",
+ "**Hint:** You might also want to review the **Project Requirements** at the start of this project, before you use `try/except`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "611e1794",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "### Data Structure 4: `planets_list`\n",
+ "\n",
+ "You are now ready to read all the data about the planets stored in the `data` directory. You **must** now create a **list** containing `Planet` objects by parsing the data inside the files `planets_1.csv`, ..., `planets_5.csv` and `mapping_1.json`, ..., `mapping_5.json`.\n",
+ "\n",
+ "You **must** skip any **broken rows** in the CSV file, and also completely skip any **broken JSON files**. However, you are **not** allowed to **hardcode** the file you need to skip. You **must** call `get_planet` on **all** 5 pairs of files to answer this question.\n",
+ "\n",
+ "You **must** use the `get_planets` function on each of the five pairs of files in the `data` directory to create `planets_list`.\n",
+ "\n",
+ "**Warning:** Recall that the ordering of the files returned by the `os.listdir` function **depends on the operating system**. So, you need to be careful if your code relies on the ordering of the **list** returned by this function. One way to avoid any issues here would be to **sort** the **list** first, so that the ordering is identical across all operating systems."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9921ff82",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.393560Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.392559Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.484082Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.483080Z"
+ },
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# define the variable 'planets_list' here,\n",
+ "# but do NOT display the variable at the end\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "25c0cad8",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"planets_list\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "19bbe569",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "If you wish to **verify** that you have read the files and defined `planets_list` correctly, you can check that `planets_list` has **5026** `Planet` objects in it. If it contains fewer or a greater number of planets, it is possible that you have accidentally parsed a broken CSV row in `planets_4.csv`, or accidentally parsed data from the broken JSON file `mapping_5.json`."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "235e87f6",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 16:** What is the output of `planets_list[5020:5025]`?\n",
+ "\n",
+ "Your output **must** be a **list** of `Planet` objects.\n",
+ "\n",
+ "**Hint:** If you did not get the right answer here, it is possible that you did not read the files in the correct **order**. In `planets_list`, the planets from `planets_1.csv` should appear first (in the order that they appear in the dataset), followed by the planets from `planets_2.csv`, `planets_3.csv`, `planets_4.csv`, and `planets_5.csv`."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "f8506324",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.543085Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.542088Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.552172Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.551171Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'planets_5020_5025', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2fdfabce",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q16\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3b712e38",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 17:** How many planets in `planets_list` were discovered in the year *2023*?\n",
+ "\n",
+ "Your output **must** be an **integer**."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "22b89d22",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.585187Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.584191Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.596436Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.595445Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'planets_disc_2023', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "0d14be92",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q17\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "f5b74c46",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 18:** Find the `Star` object around which the `Planet` named *TOI-2202 c* orbits.\n",
+ "\n",
+ "Your output **must** be a `Star` object.\n",
+ "\n",
+ "**Hint:** You **must** first find the `Planet` object with the `planet_name` *TOI-2202 c* and then use the `host_name` attribute to identify the name of the star around which the planet orbits. Then, you can get the `Star` object using the `stars_dict` **dictionary** defined above.\n",
+ "\n",
+ "You **must** exit the loop once you find the first planet with the target name."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "9beed08b",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.663418Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.662422Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.675419Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.674419Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'toi_2022_c_star', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1419f258",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q18\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d97da08c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 19:** Find the **average** `planet_radius` (in units of the radius of the Earth) of the planets that orbit stars with `stellar_radius` more than *10* (i.e. more than *10* times the radius of the Sun).\n",
+ "\n",
+ "Your output **must** be a **float**. You **must** skip any `Planet` objects with **missing** `planet_radius` data and any `Star` objects with **missing** `stellar_radius` data."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "ea5c9c38",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.739431Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.738428Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.758509Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.757519Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'avg_planet_radius_big_stars', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "4ce93cf3",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q19\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3960389a",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "**Question 20:** Find all the `Planet` objects that orbit the **youngest** `Star` object.\n",
+ "\n",
+ "Your output **must** be a **list** of `Planet` objects (even if there is **only one** `Planet` in the list). The age of a `Star` can be found from its `stellar_age` column. You do **not** have to worry about any ties. There is a **unique** `Star` in the dataset which is the youngest star."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "47751dc8",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2023-11-08T00:40:28.829590Z",
+ "iopub.status.busy": "2023-11-08T00:40:28.829590Z",
+ "iopub.status.idle": "2023-11-08T00:40:28.845621Z",
+ "shell.execute_reply": "2023-11-08T00:40:28.844622Z"
+ },
+ "lines_to_next_cell": 0,
+ "tags": []
+ },
+ "outputs": [],
+ "source": [
+ "# compute and store the answer in the variable 'youngest_star_planets', then display it\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "39afe6e0",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"q20\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "d510b9ea",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"general_deductions\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "980793ba",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "grader.check(\"summary\")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0c39321c",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ "## Submission\n",
+ "It is recommended that at this stage, you Restart and Run all Cells in your notebook.\n",
+ "That will automatically save your work and generate a zip file for you to submit.\n",
+ "\n",
+ "**SUBMISSION INSTRUCTIONS**:\n",
+ "1. **Upload** the zipfile to Gradescope.\n",
+ "2. If you completed the project with a **partner**, make sure to **add their name** by clicking \"Add Group Member\"\n",
+ "in Gradescope when uploading the zip file.\n",
+ "3. Check **Gradescope** results as soon as the auto-grader execution gets completed.\n",
+ "4. Your **final score** for this project is the score that you see on **Gradescope**.\n",
+ "5. You are **allowed** to resubmit on Gradescope as many times as you want to.\n",
+ "6. **Contact** a TA/PM if you lose any points on Gradescope for any **unclear reasons**."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "cb955e7c",
+ "metadata": {
+ "cell_type": "code",
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "# running this cell will create a new save checkpoint for your notebook\n",
+ "from IPython.display import display, Javascript\n",
+ "display(Javascript('IPython.notebook.save_checkpoint();'))"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "2d31d149",
+ "metadata": {
+ "cell_type": "code",
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "!jupytext --to py p10.ipynb"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "8b3d7b23",
+ "metadata": {
+ "cell_type": "code",
+ "deletable": false,
+ "editable": false
+ },
+ "outputs": [],
+ "source": [
+ "public_tests.check_file_size(\"p10.ipynb\")\n",
+ "grader.export(pdf=False, run_tests=False, files=[\"p10.py\"])"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "57741345",
+ "metadata": {
+ "deletable": false,
+ "editable": false
+ },
+ "source": [
+ " "
+ ]
+ }
+ ],
+ "metadata": {
+ "jupytext": {
+ "cell_metadata_filter": "-all",
+ "encoding": "# coding: utf-8",
+ "executable": "/usr/bin/env python",
+ "notebook_metadata_filter": "-all"
+ },
+ "kernelspec": {
+ "display_name": "Python 3 (ipykernel)",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.11.4"
+ },
+ "otter": {
+ "OK_FORMAT": true,
+ "tests": {
+ "Planet": {
+ "name": "Planet",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('Planet', jupiter)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('Planet: data structure is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined more than once (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('Planet: data structure is defined incorrectly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined incorrectly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "Star": {
+ "name": "Star",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('Star', sun)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('Star: data structure is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined more than once (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('Star: data structure is defined incorrectly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined incorrectly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "general_deductions": {
+ "name": "general_deductions",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('general_deductions: Outputs not visible/did not save the notebook file prior to running the cell containing \"export\". We cannot see your output if you do not save before generating the zip file.')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'Outputs not visible/did not save the notebook file prior to running the cell containing \"export\". We cannot see your output if you do not save before generating the zip file. (-3)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('general_deductions: Used concepts/modules such as csv.DictReader and pandas not covered in class yet. Note that built-in functions that you have been introduced to can be used.')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'Used concepts/modules such as csv.DictReader and pandas not covered in class yet. Note that built-in functions that you have been introduced to can be used. (-3)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('general_deductions: Used bare try/except blocks without explicitly specifying the type of exceptions that need to be caught')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'Used bare try/except blocks without explicitly specifying the type of exceptions that need to be caught (-3)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('general_deductions: Large outputs such as stars_dict or planets_list are displayed in the notebook.')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'Large outputs such as stars_dict or planets_list are displayed in the notebook. (-3)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('general_deductions: Import statements are not mentioned in the required cell at the top of the notebook.')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'Import statements are not mentioned in the required cell at the top of the notebook. (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "get_planets": {
+ "name": "get_planets",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_planets: function logic is incorrect')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function logic is incorrect (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_planets: hardcoded the name of directory inside the function instead of passing it as a part of the input argument')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'hardcoded the name of directory inside the function instead of passing it as a part of the input argument (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_planets: function is called more than twice with the same dataset')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is called more than twice with the same dataset (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_planets: `planet_cell` function is not used', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planet_cell` function is not used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_planets: function is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is defined more than once (-3)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "get_stars": {
+ "name": "get_stars",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_stars: function logic is incorrect')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function logic is incorrect (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_stars: hardcoded the name of directory inside the function instead of passing it as a part of the input argument')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'hardcoded the name of directory inside the function instead of passing it as a part of the input argument (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_stars: function is called more than twice with the same dataset')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is called more than twice with the same dataset (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_stars: `star_cell` function is not used', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`star_cell` function is not used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('get_stars: function is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is defined more than once (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "planet_cell": {
+ "name": "planet_cell",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planet_cell: function does not typecast values based on columns')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function does not typecast values based on columns (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planet_cell: column indices are hardcoded instead of using column names')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'column indices are hardcoded instead of using column names (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planet_cell: boolean values are not typecasted correctly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'boolean values are not typecasted correctly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planet_cell: function logic is incorrect')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function logic is incorrect (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planet_cell: function is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is defined more than once (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "planets_list": {
+ "name": "planets_list",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planets_list: data structure is defined incorrectly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined incorrectly (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planets_list: `get_planets` function is not used', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_planets` function is not used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('planets_list: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('planets_list: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q1": {
+ "name": "q1",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q1', files_in_data)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q1: answer is not sorted explicitly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer is not sorted explicitly (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q1: answer does not remove all files and directories that start with `.`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not remove all files and directories that start with `.` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q10": {
+ "name": "q10",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q10', biggest_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q10: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q10: `stars_dict` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_dict` data structure is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q10: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q11": {
+ "name": "q11",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q11', avg_age_kepler)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q11: answer does not check for only stars that start with `Kepler`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not check for only stars that start with `Kepler` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q11: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q11: `stars_dict` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_dict` data structure is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q12": {
+ "name": "q12",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q12', fifth_planet)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q12: `planet_cell` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planet_cell` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q12: `mapping_1_json` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`mapping_1_json` data structure is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q12: answer unnecessarily iterates over the entire dataset')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer unnecessarily iterates over the entire dataset (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q12: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q13": {
+ "name": "q13",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q13', last_five_planets_1)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q13: `get_planets` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_planets` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q13: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q13: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q14": {
+ "name": "q14",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q14', controversial_planets)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q14: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q14: `get_planets` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_planets` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q14: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q14: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q15": {
+ "name": "q15",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q15', last_five_planets_4)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q15: `get_planets` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_planets` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q15: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q15: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q16": {
+ "name": "q16",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q16', planets_5020_5025)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q16: `planets_list` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planets_list` data structure is not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q17": {
+ "name": "q17",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q17', planets_disc_2023)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q17: incorrect comparison operator is used')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect comparison operator is used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q17: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q17: `planets_list` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planets_list` data structure is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q18": {
+ "name": "q18",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q18', toi_2022_c_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q18: `planets_list` and `stars_dict` data structures are not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planets_list` and `stars_dict` data structures are not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q18: did not exit loop and instead iterated further after finding the answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'did not exit loop and instead iterated further after finding the answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q18: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q19": {
+ "name": "q19",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q19', avg_planet_radius_big_stars)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q19: incorrect comparison operator is used')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect comparison operator is used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q19: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q19: `planets_list` and `stars_dict` data structures are not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planets_list` and `stars_dict` data structures are not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q19: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q2": {
+ "name": "q2",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q2', file_paths)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q2: recomputed variable defined in Question 1, or the answer is not sorted explicitly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'recomputed variable defined in Question 1, or the answer is not sorted explicitly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q2: answer does not remove all files and directories that start with `.`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not remove all files and directories that start with `.` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q2: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q2: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q20": {
+ "name": "q20",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q20', youngest_star_planets)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q20: answer does not include all Planets that orbit the Star')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not include all Planets that orbit the Star (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q20: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q20: `planets_list` and `stars_dict` data structures are not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`planets_list` and `stars_dict` data structures are not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q20: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q3": {
+ "name": "q3",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q3', csv_file_paths)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q3: recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q3: answer does not remove all files and directories that start with `.`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not remove all files and directories that start with `.` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q3: answer does not check only for files that end with `.csv`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not check only for files that end with `.csv` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q3: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q3: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q4": {
+ "name": "q4",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q4', stars_paths)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q4: recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q4: answer does not remove all files and directories that start with `.`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not remove all files and directories that start with `.` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q4: answer does not check for only files that start with `stars`')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer does not check for only files that start with `stars` (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q4: paths are hardcoded using slashes')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'paths are hardcoded using slashes (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q4: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q5": {
+ "name": "q5",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q5', third_star)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q5: `star_cell` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`star_cell` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q5: answer unnecessarily iterates over the entire dataset')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'answer unnecessarily iterates over the entire dataset (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q5: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q6": {
+ "name": "q6",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q6', dp_leo)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q6: `stars_1_dict` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_1_dict` data structure is not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q7": {
+ "name": "q7",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q7', avg_lum_stars_1)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q7: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q7: `stars_1_dict` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_1_dict` data structure is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q7: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q8": {
+ "name": "q8",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q8', avg_age_stars_2)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q8: incorrect logic is used to answer')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'incorrect logic is used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q8: `get_stars` function is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_stars` function is not used to answer (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> public_tests.rubric_check('q8: public tests')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "q9": {
+ "name": "q9",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.check('q9', kepler_220_temp)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('q9: `stars_dict` data structure is not used to answer', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_dict` data structure is not used to answer (-2)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "star_cell": {
+ "name": "star_cell",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('star_cell: function does not typecast values based on columns')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function does not typecast values based on columns (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('star_cell: column indices are hardcoded instead of using column names')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'column indices are hardcoded instead of using column names (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('star_cell: function logic is incorrect')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function logic is incorrect (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('star_cell: function is defined more than once')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'function is defined more than once (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "stars_dict": {
+ "name": "stars_dict",
+ "points": 0,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('stars_dict: data structure is defined incorrectly')\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - 'data structure is defined incorrectly (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('stars_dict: `get_stars` function is not used', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`get_stars` function is not used (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ },
+ {
+ "code": ">>> \n>>> public_tests.rubric_check('stars_dict: `stars_paths` is not used to find paths of necessary files', False)\nAll test cases passed!\n",
+ "hidden": false,
+ "locked": false,
+ "success_message": "Note that the Gradescope autograder will deduct points if your code fails the following rubric point - '`stars_paths` is not used to find paths of necessary files (-1)'. The public tests cannot determine if your code satisfies these requirements. Verify your code manually."
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ },
+ "summary": {
+ "name": "summary",
+ "points": 127,
+ "suites": [
+ {
+ "cases": [
+ {
+ "code": ">>> public_tests.get_summary()\nTotal Score: 100/100\n",
+ "hidden": false,
+ "locked": false
+ }
+ ],
+ "scored": true,
+ "setup": "",
+ "teardown": "",
+ "type": "doctest"
+ }
+ ]
+ }
+ }
+ },
+ "vscode": {
+ "interpreter": {
+ "hash": "14da47bd65ade4b245ff2b2e979dfbf7dfc83de2bd52e30e561cd592f0ba2dfc"
+ }
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/p10/public_tests.py b/p10/public_tests.py
new file mode 100644
index 0000000..06d0052
--- /dev/null
+++ b/p10/public_tests.py
@@ -0,0 +1,878 @@
+#!/usr/bin/python
+# +
+import os, json, math, copy
+from collections import namedtuple
+from bs4 import BeautifulSoup
+
+HIDDEN_FILE = os.path.join("hidden", "hidden_tests.py")
+if os.path.exists(HIDDEN_FILE):
+ import hidden.hidden_tests as hidn
+# -
+
+MAX_FILE_SIZE = 750 # units - KB
+REL_TOL = 6e-04 # relative tolerance for floats
+ABS_TOL = 15e-03 # absolute tolerance for floats
+TOTAL_SCORE = 100 # total score for the project
+
+DF_FILE = 'expected_dfs.html'
+PLOT_FILE = 'expected_plots.json'
+
+PASS = "All test cases passed!"
+
+TEXT_FORMAT = "TEXT_FORMAT" # question type when expected answer is a type, str, int, float, or bool
+TEXT_FORMAT_UNORDERED_LIST = "TEXT_FORMAT_UNORDERED_LIST" # question type when the expected answer is a list or a set where the order does *not* matter
+TEXT_FORMAT_ORDERED_LIST = "TEXT_FORMAT_ORDERED_LIST" # question type when the expected answer is a list or tuple where the order does matter
+TEXT_FORMAT_DICT = "TEXT_FORMAT_DICT" # question type when the expected answer is a dictionary
+TEXT_FORMAT_SPECIAL_ORDERED_LIST = "TEXT_FORMAT_SPECIAL_ORDERED_LIST" # question type when the expected answer is a list where order does matter, but with possible ties. Elements are ordered according to values in special_ordered_json (with ties allowed)
+TEXT_FORMAT_NAMEDTUPLE = "TEXT_FORMAT_NAMEDTUPLE" # question type when expected answer is a namedtuple
+PNG_FORMAT_SCATTER = "PNG_FORMAT_SCATTER" # question type when the expected answer is a scatter plot
+HTML_FORMAT = "HTML_FORMAT" # question type when the expected answer is a DataFrame
+FILE_JSON_FORMAT = "FILE_JSON_FORMAT" # question type when the expected answer is a JSON file
+SLASHES = "SLASHES" # question SUFFIX when expected answer contains paths with slashes
+
+def get_expected_format():
+ """get_expected_format() returns a dict mapping each question to the format
+ of the expected answer."""
+ expected_format = {'q1': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q2': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'q3': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'q4': 'TEXT_FORMAT_ORDERED_LIST_SLASHES',
+ 'Star': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q5': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q6': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q7': 'TEXT_FORMAT',
+ 'q8': 'TEXT_FORMAT',
+ 'q9': 'TEXT_FORMAT',
+ 'q10': 'TEXT_FORMAT',
+ 'q11': 'TEXT_FORMAT',
+ 'Planet': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q12': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q13': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q14': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q15': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q16': 'TEXT_FORMAT_ORDERED_LIST',
+ 'q17': 'TEXT_FORMAT',
+ 'q18': 'TEXT_FORMAT_NAMEDTUPLE',
+ 'q19': 'TEXT_FORMAT',
+ 'q20': 'TEXT_FORMAT_UNORDERED_LIST'}
+ return expected_format
+
+
+def get_expected_json():
+ """get_expected_json() returns a dict mapping each question to the expected
+ answer (if the format permits it)."""
+ expected_json = {'q1': ['stars_5.csv',
+ 'stars_4.csv',
+ 'stars_3.csv',
+ 'stars_2.csv',
+ 'stars_1.csv',
+ 'planets_5.csv',
+ 'planets_4.csv',
+ 'planets_3.csv',
+ 'planets_2.csv',
+ 'planets_1.csv',
+ 'mapping_5.json',
+ 'mapping_4.json',
+ 'mapping_3.json',
+ 'mapping_2.json',
+ 'mapping_1.json'],
+ 'q2': ['data\\stars_5.csv',
+ 'data\\stars_4.csv',
+ 'data\\stars_3.csv',
+ 'data\\stars_2.csv',
+ 'data\\stars_1.csv',
+ 'data\\planets_5.csv',
+ 'data\\planets_4.csv',
+ 'data\\planets_3.csv',
+ 'data\\planets_2.csv',
+ 'data\\planets_1.csv',
+ 'data\\mapping_5.json',
+ 'data\\mapping_4.json',
+ 'data\\mapping_3.json',
+ 'data\\mapping_2.json',
+ 'data\\mapping_1.json'],
+ 'q3': ['data\\stars_5.csv',
+ 'data\\stars_4.csv',
+ 'data\\stars_3.csv',
+ 'data\\stars_2.csv',
+ 'data\\stars_1.csv',
+ 'data\\planets_5.csv',
+ 'data\\planets_4.csv',
+ 'data\\planets_3.csv',
+ 'data\\planets_2.csv',
+ 'data\\planets_1.csv'],
+ 'q4': ['data\\stars_5.csv',
+ 'data\\stars_4.csv',
+ 'data\\stars_3.csv',
+ 'data\\stars_2.csv',
+ 'data\\stars_1.csv'],
+ 'Star': Star(spectral_type='G2 V', stellar_effective_temperature=5780.0, stellar_radius=1.0, stellar_mass=1.0, stellar_luminosity=0.0, stellar_surface_gravity=4.44, stellar_age=4.6),
+ 'q5': Star(spectral_type='K0III', stellar_effective_temperature=4888.0, stellar_radius=11.55, stellar_mass=1.78, stellar_luminosity=1.84, stellar_surface_gravity=2.55, stellar_age=4.5),
+ 'q6': Star(spectral_type=None, stellar_effective_temperature=13500.0, stellar_radius=0.01, stellar_mass=0.69, stellar_luminosity=-2.4, stellar_surface_gravity=None, stellar_age=None),
+ 'q7': 0.01624010554089703,
+ 'q8': 4.3255604996096775,
+ 'q9': 4632.0,
+ 'q10': 'HD 81817',
+ 'q11': 4.245366288492731,
+ 'Planet': Planet(planet_name='Jupiter', host_name='Sun', discovery_method='Imaging', discovery_year=1610, controversial_flag=False, orbital_period=4333.0, planet_radius=11.209, planet_mass=317.828, semi_major_radius=5.2038, eccentricity=0.0489, equilibrium_temperature=110, insolation_flux=0.0345),
+ 'q12': Planet(planet_name='17 Sco b', host_name='17 Sco', discovery_method='Radial Velocity', discovery_year=2020, controversial_flag=False, orbital_period=578.38, planet_radius=12.9, planet_mass=1373.01872, semi_major_radius=1.45, eccentricity=0.06, equilibrium_temperature=None, insolation_flux=None),
+ 'q13': [Planet(planet_name='Kepler-1494 b', host_name='Kepler-1494', discovery_method='Transit', discovery_year=2016, controversial_flag=False, orbital_period=91.080482, planet_radius=3.07, planet_mass=9.64, semi_major_radius=0.3982, eccentricity=0.0, equilibrium_temperature=415.0, insolation_flux=9.11),
+ Planet(planet_name='Kepler-1495 b', host_name='Kepler-1495', discovery_method='Transit', discovery_year=2016, controversial_flag=False, orbital_period=85.273256, planet_radius=2.94, planet_mass=8.96, semi_major_radius=0.3677, eccentricity=0.0, equilibrium_temperature=443.0, insolation_flux=9.1),
+ Planet(planet_name='Kepler-1496 b', host_name='Kepler-1496', discovery_method='Transit', discovery_year=2016, controversial_flag=False, orbital_period=64.6588017, planet_radius=2.22, planet_mass=5.56, semi_major_radius=0.3211, eccentricity=0.0, equilibrium_temperature=535.0, insolation_flux=18.38),
+ Planet(planet_name='Kepler-1497 b', host_name='Kepler-1497', discovery_method='Transit', discovery_year=2016, controversial_flag=False, orbital_period=8.74199772, planet_radius=1.66, planet_mass=3.39, semi_major_radius=0.0817, eccentricity=0.0, equilibrium_temperature=924.0, insolation_flux=172.38),
+ Planet(planet_name='TOI-784 b', host_name='HD 307842', discovery_method='Transit', discovery_year=2023, controversial_flag=False, orbital_period=2.7970365, planet_radius=1.93, planet_mass=9.67, semi_major_radius=0.038, eccentricity=0.0, equilibrium_temperature=1256.0, insolation_flux=413.89)],
+ 'q14': [Planet(planet_name='Kepler-452 b', host_name='Kepler-452', discovery_method='Transit', discovery_year=2015, controversial_flag=True, orbital_period=384.843, planet_radius=1.63, planet_mass=3.29, semi_major_radius=1.046, eccentricity=0.0, equilibrium_temperature=265.0, insolation_flux=1.1),
+ Planet(planet_name='Kepler-747 b', host_name='Kepler-747', discovery_method='Transit', discovery_year=2016, controversial_flag=True, orbital_period=35.61760587, planet_radius=5.27, planet_mass=24.1, semi_major_radius=0.1916, eccentricity=0.0, equilibrium_temperature=456.0, insolation_flux=10.19),
+ Planet(planet_name='V830 Tau b', host_name='V830 Tau', discovery_method='Radial Velocity', discovery_year=2016, controversial_flag=True, orbital_period=4.927, planet_radius=14.0, planet_mass=222.481, semi_major_radius=0.057, eccentricity=0.0, equilibrium_temperature=None, insolation_flux=None),
+ Planet(planet_name='nu Oct A b', host_name='nu Oct A', discovery_method='Radial Velocity', discovery_year=2016, controversial_flag=True, orbital_period=417.0, planet_radius=13.3, planet_mass=762.78818, semi_major_radius=1.25, eccentricity=0.11, equilibrium_temperature=None, insolation_flux=None)],
+ 'q15': [Planet(planet_name='Wolf 1061 b', host_name='Wolf 1061', discovery_method='Radial Velocity', discovery_year=2015, controversial_flag=False, orbital_period=4.8869, planet_radius=1.21, planet_mass=1.91, semi_major_radius=0.0375, eccentricity=0.15, equilibrium_temperature=None, insolation_flux=7.34),
+ Planet(planet_name='Wolf 1061 c', host_name='Wolf 1061', discovery_method='Radial Velocity', discovery_year=2015, controversial_flag=False, orbital_period=17.8719, planet_radius=1.66, planet_mass=3.41, semi_major_radius=0.089, eccentricity=0.11, equilibrium_temperature=None, insolation_flux=1.3),
+ Planet(planet_name='YZ Cet b', host_name='YZ Cet', discovery_method='Radial Velocity', discovery_year=2017, controversial_flag=False, orbital_period=2.02087, planet_radius=0.913, planet_mass=0.7, semi_major_radius=0.01634, eccentricity=0.06, equilibrium_temperature=471.0, insolation_flux=8.21),
+ Planet(planet_name='ups And b', host_name='ups And', discovery_method='Radial Velocity', discovery_year=1996, controversial_flag=False, orbital_period=4.617033, planet_radius=14.0, planet_mass=218.531, semi_major_radius=0.059222, eccentricity=0.0215, equilibrium_temperature=None, insolation_flux=None),
+ Planet(planet_name='ups And d', host_name='ups And', discovery_method='Radial Velocity', discovery_year=1999, controversial_flag=False, orbital_period=1276.46, planet_radius=12.5, planet_mass=3257.74117, semi_major_radius=2.51329, eccentricity=0.2987, equilibrium_temperature=None, insolation_flux=None)],
+ 'q16': [Planet(planet_name='TOI-712 d', host_name='TOI-712', discovery_method='Transit', discovery_year=2022, controversial_flag=False, orbital_period=84.8396, planet_radius=2.474, planet_mass=6.68, semi_major_radius=0.3405, eccentricity=0.073, equilibrium_temperature=314.0, insolation_flux=1.6),
+ Planet(planet_name='Wolf 1061 b', host_name='Wolf 1061', discovery_method='Radial Velocity', discovery_year=2015, controversial_flag=False, orbital_period=4.8869, planet_radius=1.21, planet_mass=1.91, semi_major_radius=0.0375, eccentricity=0.15, equilibrium_temperature=None, insolation_flux=7.34),
+ Planet(planet_name='Wolf 1061 c', host_name='Wolf 1061', discovery_method='Radial Velocity', discovery_year=2015, controversial_flag=False, orbital_period=17.8719, planet_radius=1.66, planet_mass=3.41, semi_major_radius=0.089, eccentricity=0.11, equilibrium_temperature=None, insolation_flux=1.3),
+ Planet(planet_name='YZ Cet b', host_name='YZ Cet', discovery_method='Radial Velocity', discovery_year=2017, controversial_flag=False, orbital_period=2.02087, planet_radius=0.913, planet_mass=0.7, semi_major_radius=0.01634, eccentricity=0.06, equilibrium_temperature=471.0, insolation_flux=8.21),
+ Planet(planet_name='ups And b', host_name='ups And', discovery_method='Radial Velocity', discovery_year=1996, controversial_flag=False, orbital_period=4.617033, planet_radius=14.0, planet_mass=218.531, semi_major_radius=0.059222, eccentricity=0.0215, equilibrium_temperature=None, insolation_flux=None)],
+ 'q17': 256,
+ 'q18': Star(spectral_type='K8V', stellar_effective_temperature=5144.0, stellar_radius=0.79, stellar_mass=0.82, stellar_luminosity=-0.401, stellar_surface_gravity=4.55, stellar_age=7.48),
+ 'q19': 12.888118811881188,
+ 'q20': [Planet(planet_name='Kepler-1663 b', host_name='Kepler-1663', discovery_method='Transit', discovery_year=2020, controversial_flag=False, orbital_period=17.6046, planet_radius=3.304, planet_mass=10.9, semi_major_radius=0.1072, eccentricity=0.0, equilibrium_temperature=362.0, insolation_flux=4.07)]}
+ return expected_json
+
+
+def get_special_json():
+ """get_special_json() returns a dict mapping each question to the expected
+ answer stored in a special format as a list of tuples. Each tuple contains
+ the element expected in the list, and its corresponding value. Any two
+ elements with the same value can appear in any order in the actual list,
+ but if two elements have different values, then they must appear in the
+ same order as in the expected list of tuples."""
+ special_json = {}
+ return special_json
+
+
+def compare(expected, actual, q_format=TEXT_FORMAT):
+ """compare(expected, actual) is used to compare when the format of
+ the expected answer is known for certain."""
+ try:
+ if q_format == TEXT_FORMAT:
+ return simple_compare(expected, actual)
+ elif q_format == TEXT_FORMAT_UNORDERED_LIST:
+ return list_compare_unordered(expected, actual)
+ elif q_format == TEXT_FORMAT_ORDERED_LIST:
+ return list_compare_ordered(expected, actual)
+ elif q_format == TEXT_FORMAT_DICT:
+ return dict_compare(expected, actual)
+ elif q_format == TEXT_FORMAT_SPECIAL_ORDERED_LIST:
+ return list_compare_special(expected, actual)
+ elif q_format == TEXT_FORMAT_NAMEDTUPLE:
+ return namedtuple_compare(expected, actual)
+ elif q_format == PNG_FORMAT_SCATTER:
+ return compare_flip_dicts(expected, actual)
+ elif q_format == HTML_FORMAT:
+ return compare_cell_html(expected, actual)
+ elif q_format == FILE_JSON_FORMAT:
+ return compare_json(expected, actual)
+ else:
+ if expected != actual:
+ return "expected %s but found %s " % (repr(expected), repr(actual))
+ except:
+ if expected != actual:
+ return "expected %s" % (repr(expected))
+ return PASS
+
+
+def print_message(expected, actual, complete_msg=True):
+ """print_message(expected, actual) displays a simple error message."""
+ msg = "expected %s" % (repr(expected))
+ if complete_msg:
+ msg = msg + " but found %s" % (repr(actual))
+ return msg
+
+
+def simple_compare(expected, actual, complete_msg=True):
+ """simple_compare(expected, actual) is used to compare when the expected answer
+ is a type/Nones/str/int/float/bool. When the expected answer is a float,
+ the actual answer is allowed to be within the tolerance limit. Otherwise,
+ the values must match exactly, or a very simple error message is displayed."""
+ msg = PASS
+ if 'numpy' in repr(type((actual))):
+ actual = actual.item()
+ if isinstance(expected, type):
+ if expected != actual:
+ if isinstance(actual, type):
+ msg = "expected %s but found %s" % (expected.__name__, actual.__name__)
+ else:
+ msg = "expected %s but found %s" % (expected.__name__, repr(actual))
+ elif not isinstance(actual, type(expected)):
+ if not (isinstance(expected, (float, int)) and isinstance(actual, (float, int))):
+ if not is_namedtuple(expected):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ elif isinstance(expected, float):
+ if not math.isclose(actual, expected, rel_tol=REL_TOL, abs_tol=ABS_TOL):
+ msg = print_message(expected, actual, complete_msg)
+ elif isinstance(expected, (list, tuple)) or is_namedtuple(expected):
+ new_msg = print_message(expected, actual, complete_msg)
+ if len(expected) != len(actual):
+ return new_msg
+ for i in range(len(expected)):
+ val = simple_compare(expected[i], actual[i])
+ if val != PASS:
+ return new_msg
+ elif isinstance(expected, dict):
+ new_msg = print_message(expected, actual, complete_msg)
+ if len(expected) != len(actual):
+ return new_msg
+ val = simpe_compare(sorted(list(expected.keys())), sorted(list(actual.keys())))
+ if val != PASS:
+ return new_msg
+ for key in expected:
+ val = simple_compare(expected[key], actual[key])
+ if val != PASS:
+ return new_msg
+ else:
+ if expected != actual:
+ msg = print_message(expected, actual, complete_msg)
+ return msg
+
+
+def intelligent_compare(expected, actual, obj=None):
+ """intelligent_compare(expected, actual) is used to compare when the
+ data type of the expected answer is not known for certain, and default
+ assumptions need to be made."""
+ if obj == None:
+ obj = type(expected).__name__
+ if is_namedtuple(expected):
+ msg = namedtuple_compare(expected, actual)
+ elif isinstance(expected, (list, tuple)):
+ msg = list_compare_ordered(expected, actual, obj)
+ elif isinstance(expected, set):
+ msg = list_compare_unordered(expected, actual, obj)
+ elif isinstance(expected, (dict)):
+ msg = dict_compare(expected, actual)
+ else:
+ msg = simple_compare(expected, actual)
+ msg = msg.replace("CompDict", "dict").replace("CompSet", "set").replace("NewNone", "None")
+ return msg
+
+
+def is_namedtuple(obj, init_check=True):
+ """is_namedtuple(obj) returns True if `obj` is a namedtuple object
+ defined in the test file."""
+ bases = type(obj).__bases__
+ if len(bases) != 1 or bases[0] != tuple:
+ return False
+ fields = getattr(type(obj), '_fields', None)
+ if not isinstance(fields, tuple):
+ return False
+ if init_check and not type(obj).__name__ in [nt.__name__ for nt in _expected_namedtuples]:
+ return False
+ return True
+
+
+def list_compare_ordered(expected, actual, obj=None):
+ """list_compare_ordered(expected, actual) is used to compare when the
+ expected answer is a list/tuple, where the order of the elements matters."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+ for i in range(len(expected)):
+ if i >= len(actual):
+ msg = "at index %d of the %s, expected missing %s" % (i, obj, repr(expected[i]))
+ break
+ val = intelligent_compare(expected[i], actual[i], "sub" + obj)
+ if val != PASS:
+ msg = "at index %d of the %s, " % (i, obj) + val
+ break
+ if len(actual) > len(expected) and msg == PASS:
+ msg = "at index %d of the %s, found unexpected %s" % (len(expected), obj, repr(actual[len(expected)]))
+ if len(expected) != len(actual):
+ msg = msg + " (found %d entries in %s, but expected %d)" % (len(actual), obj, len(expected))
+
+ if len(expected) > 0:
+ try:
+ if msg != PASS and list_compare_unordered(expected, actual, obj) == PASS:
+ msg = msg + " (%s may not be ordered as required)" % (obj)
+ except:
+ pass
+ return msg
+
+
+def list_compare_helper(larger, smaller):
+ """list_compare_helper(larger, smaller) is a helper function which takes in
+ two lists of possibly unequal sizes and finds the item that is not present
+ in the smaller list, if there is such an element."""
+ msg = PASS
+ j = 0
+ for i in range(len(larger)):
+ if i == len(smaller):
+ msg = "expected %s" % (repr(larger[i]))
+ break
+ found = False
+ while not found:
+ if j == len(smaller):
+ val = simple_compare(larger[i], smaller[j - 1], complete_msg=False)
+ break
+ val = simple_compare(larger[i], smaller[j], complete_msg=False)
+ j += 1
+ if val == PASS:
+ found = True
+ break
+ if not found:
+ msg = val
+ break
+ return msg
+
+class NewNone():
+ """alternate class in place of None, which allows for comparison with
+ all other data types."""
+ def __str__(self):
+ return 'None'
+ def __repr__(self):
+ return 'None'
+ def __lt__(self, other):
+ return True
+ def __le__(self, other):
+ return True
+ def __gt__(self, other):
+ return False
+ def __ge__(self, other):
+ return other == None
+ def __eq__(self, other):
+ return other == None
+ def __ne__(self, other):
+ return other != None
+
+class CompDict(dict):
+ """subclass of dict, which allows for comparison with other dicts."""
+ def __init__(self, vals):
+ super(self.__class__, self).__init__(vals)
+ if type(vals) == CompDict:
+ self.val = vals.val
+ elif isinstance(vals, dict):
+ self.val = self.get_equiv(vals)
+ else:
+ raise TypeError("'%s' object cannot be type casted to CompDict class" % type(vals).__name__)
+
+ def get_equiv(self, vals):
+ val = []
+ for key in sorted(list(vals.keys())):
+ val.append((key, vals[key]))
+ return val
+
+ def __str__(self):
+ return str(dict(self.val))
+ def __repr__(self):
+ return repr(dict(self.val))
+ def __lt__(self, other):
+ return self.val < CompDict(other).val
+ def __le__(self, other):
+ return self.val <= CompDict(other).val
+ def __gt__(self, other):
+ return self.val > CompDict(other).val
+ def __ge__(self, other):
+ return self.val >= CompDict(other).val
+ def __eq__(self, other):
+ return self.val == CompDict(other).val
+ def __ne__(self, other):
+ return self.val != CompDict(other).val
+
+class CompSet(set):
+ """subclass of set, which allows for comparison with other sets."""
+ def __init__(self, vals):
+ super(self.__class__, self).__init__(vals)
+ if type(vals) == CompSet:
+ self.val = vals.val
+ elif isinstance(vals, set):
+ self.val = self.get_equiv(vals)
+ else:
+ raise TypeError("'%s' object cannot be type casted to CompSet class" % type(vals).__name__)
+
+ def get_equiv(self, vals):
+ return sorted(list(vals))
+
+ def __str__(self):
+ return str(set(self.val))
+ def __repr__(self):
+ return repr(set(self.val))
+ def __getitem__(self, index):
+ return self.val[index]
+ def __lt__(self, other):
+ return self.val < CompSet(other).val
+ def __le__(self, other):
+ return self.val <= CompSet(other).val
+ def __gt__(self, other):
+ return self.val > CompSet(other).val
+ def __ge__(self, other):
+ return self.val >= CompSet(other).val
+ def __eq__(self, other):
+ return self.val == CompSet(other).val
+ def __ne__(self, other):
+ return self.val != CompSet(other).val
+
+def make_sortable(item):
+ """make_sortable(item) replaces all Nones in `item` with an alternate
+ class that allows for comparison with str/int/float/bool/list/set/tuple/dict.
+ It also replaces all dicts (and sets) with a subclass that allows for
+ comparison with other dicts (and sets)."""
+ if item == None:
+ return NewNone()
+ elif isinstance(item, (type, str, int, float, bool)):
+ return item
+ elif isinstance(item, (list, set, tuple)):
+ new_item = []
+ for subitem in item:
+ new_item.append(make_sortable(subitem))
+ if is_namedtuple(item):
+ return type(item)(*new_item)
+ elif isinstance(item, set):
+ return CompSet(new_item)
+ else:
+ return type(item)(new_item)
+ elif isinstance(item, dict):
+ new_item = {}
+ for key in item:
+ new_item[key] = make_sortable(item[key])
+ return CompDict(new_item)
+ return item
+
+def list_compare_unordered(expected, actual, obj=None):
+ """list_compare_unordered(expected, actual) is used to compare when the
+ expected answer is a list/set where the order of the elements does not matter."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+
+ try:
+ sort_expected = sorted(make_sortable(expected))
+ sort_actual = sorted(make_sortable(actual))
+ except:
+ return "unexpected datatype found in %s; expected entries of type %s" % (obj, obj, type(expected[0]).__name__)
+
+ if len(actual) == 0 and len(expected) > 0:
+ msg = "in the %s, missing " % (obj) + sort_expected[0]
+ elif len(actual) > 0 and len(expected) > 0:
+ val = intelligent_compare(sort_expected[0], sort_actual[0])
+ if val.startswith("expected to find type"):
+ msg = "in the %s, " % (obj) + simple_compare(sort_expected[0], sort_actual[0])
+ else:
+ if len(expected) > len(actual):
+ msg = "in the %s, missing " % (obj) + list_compare_helper(sort_expected, sort_actual)
+ elif len(expected) < len(actual):
+ msg = "in the %s, found un" % (obj) + list_compare_helper(sort_actual, sort_expected)
+ if len(expected) != len(actual):
+ msg = msg + " (found %d entries in %s, but expected %d)" % (len(actual), obj, len(expected))
+ return msg
+ else:
+ val = list_compare_helper(sort_expected, sort_actual)
+ if val != PASS:
+ msg = "in the %s, missing " % (obj) + val + ", but found un" + list_compare_helper(sort_actual,
+ sort_expected)
+ return msg
+
+
+def namedtuple_compare(expected, actual):
+ """namedtuple_compare(expected, actual) is used to compare when the
+ expected answer is a namedtuple defined in the test file."""
+ msg = PASS
+ if not is_namedtuple(actual, False):
+ msg = "expected namedtuple but found %s" % (type(actual).__name__)
+ return msg
+ if type(expected).__name__ != type(actual).__name__:
+ return "expected namedtuple %s but found namedtuple %s" % (type(expected).__name__, type(actual).__name__)
+ expected_fields = expected._fields
+ actual_fields = actual._fields
+ msg = list_compare_ordered(list(expected_fields), list(actual_fields), "namedtuple attributes")
+ if msg != PASS:
+ return msg
+ for field in expected_fields:
+ val = intelligent_compare(getattr(expected, field), getattr(actual, field))
+ if val != PASS:
+ msg = "at attribute %s of namedtuple %s, " % (field, type(expected).__name__) + val
+ return msg
+ return msg
+
+
+def clean_slashes(item):
+ """clean_slashes()"""
+ if isinstance(item, str):
+ return item.replace("\\", "/").replace("/", os.path.sep)
+ elif item == None or isinstance(item, (type, int, float, bool)):
+ return item
+ elif isinstance(item, (list, tuple, set)) or is_namedtuple(item):
+ new_item = []
+ for subitem in item:
+ new_item.append(clean_slashes(subitem))
+ if is_namedtuple(item):
+ return type(item)(*new_item)
+ else:
+ return type(item)(new_item)
+ elif isinstance(item, dict):
+ new_item = {}
+ for key in item:
+ new_item[clean_slashes(key)] = clean_slashes(item[key])
+ return item
+
+
+def list_compare_special_initialize(special_expected):
+ """list_compare_special_initialize(special_expected) takes in the special
+ ordering stored as a sorted list of items, and returns a list of lists
+ where the ordering among the inner lists does not matter."""
+ latest_val = None
+ clean_special = []
+ for row in special_expected:
+ if latest_val == None or row[1] != latest_val:
+ clean_special.append([])
+ latest_val = row[1]
+ clean_special[-1].append(row[0])
+ return clean_special
+
+
+def list_compare_special(special_expected, actual):
+ """list_compare_special(special_expected, actual) is used to compare when the
+ expected answer is a list with special ordering defined in `special_expected`."""
+ msg = PASS
+ expected_list = []
+ special_order = list_compare_special_initialize(special_expected)
+ for expected_item in special_order:
+ expected_list.extend(expected_item)
+ val = list_compare_unordered(expected_list, actual)
+ if val != PASS:
+ return val
+ i = 0
+ for expected_item in special_order:
+ j = len(expected_item)
+ actual_item = actual[i: i + j]
+ val = list_compare_unordered(expected_item, actual_item)
+ if val != PASS:
+ if j == 1:
+ msg = "at index %d " % (i) + val
+ else:
+ msg = "between indices %d and %d " % (i, i + j - 1) + val
+ msg = msg + " (list may not be ordered as required)"
+ break
+ i += j
+ return msg
+
+
+def dict_compare(expected, actual, obj=None):
+ """dict_compare(expected, actual) is used to compare when the expected answer
+ is a dict."""
+ msg = PASS
+ if not isinstance(actual, type(expected)):
+ msg = "expected to find type %s but found type %s" % (type(expected).__name__, type(actual).__name__)
+ return msg
+ if obj == None:
+ obj = type(expected).__name__
+
+ expected_keys = list(expected.keys())
+ actual_keys = list(actual.keys())
+ val = list_compare_unordered(expected_keys, actual_keys, obj)
+
+ if val != PASS:
+ msg = "bad keys in %s: " % (obj) + val
+ if msg == PASS:
+ for key in expected:
+ new_obj = None
+ if isinstance(expected[key], (list, tuple, set)):
+ new_obj = 'value'
+ elif isinstance(expected[key], dict):
+ new_obj = 'sub' + obj
+ val = intelligent_compare(expected[key], actual[key], new_obj)
+ if val != PASS:
+ msg = "incorrect value for key %s in %s: " % (repr(key), obj) + val
+ return msg
+
+
+def is_flippable(item):
+ """is_flippable(item) determines if the given dict of lists has lists of the
+ same length and is therefore flippable."""
+ item_lens = set(([str(len(item[key])) for key in item]))
+ if len(item_lens) == 1:
+ return PASS
+ else:
+ return "found lists of lengths %s" % (", ".join(list(item_lens)))
+
+def flip_dict_of_lists(item):
+ """flip_dict_of_lists(item) flips a dict of lists into a list of dicts if the
+ lists are of same length."""
+ new_item = []
+ length = len(list(item.values())[0])
+ for i in range(length):
+ new_dict = {}
+ for key in item:
+ new_dict[key] = item[key][i]
+ new_item.append(new_dict)
+ return new_item
+
+def compare_flip_dicts(expected, actual, obj="lists"):
+ """compare_flip_dicts(expected, actual) flips a dict of lists (or dicts) into
+ a list of dicts (or dict of dicts) and then compares the list ignoring order."""
+ msg = PASS
+ example_item = list(expected.values())[0]
+ if isinstance(example_item, (list, tuple)):
+ val = is_flippable(actual)
+ if val != PASS:
+ msg = "expected to find lists of length %d, but " % (len(example_item)) + val
+ return msg
+ msg = list_compare_unordered(flip_dict_of_lists(expected), flip_dict_of_lists(actual), "lists")
+ elif isinstance(example_item, dict):
+ expected_keys = list(example_item.keys())
+ for key in actual:
+ val = list_compare_unordered(expected_keys, list(actual[key].keys()), "dictionary %s" % key)
+ if val != PASS:
+ return val
+ for cat_key in expected_keys:
+ expected_category = {}
+ actual_category = {}
+ for key in expected:
+ expected_category[key] = expected[key][cat_key]
+ actual_category[key] = actual[key][cat_key]
+ val = list_compare_unordered(flip_dict_of_lists(expected), flip_dict_of_lists(actual), "category " + repr(cat_key))
+ if val != PASS:
+ return val
+ return msg
+
+
+def get_expected_tables():
+ """get_expected_tables() reads the html file with the expected DataFrames
+ and returns a dict mapping each question to a html table."""
+ if not os.path.exists(DF_FILE):
+ return None
+
+ expected_tables = {}
+ f = open(DF_FILE, encoding='utf-8')
+ soup = BeautifulSoup(f.read(), 'html.parser')
+ f.close()
+
+ tables = soup.find_all('table')
+ for table in tables:
+ expected_tables[table.get("data-question")] = table
+
+ return expected_tables
+
+def parse_df_html_table(table):
+ """parse_df_html_table(table) takes in a table as a html string and returns
+ a dict mapping each row and column index to the value at that position."""
+ rows = []
+ for tr in table.find_all('tr'):
+ rows.append([])
+ for cell in tr.find_all(['td', 'th']):
+ rows[-1].append(cell.get_text().strip("\n "))
+
+ cells = {}
+ for r in range(1, len(rows)):
+ for c in range(1, len(rows[0])):
+ rname = rows[r][0]
+ cname = rows[0][c]
+ cells[(rname,cname)] = rows[r][c]
+ return cells
+
+
+def get_expected_namedtuples():
+ """get_expected_namedtuples() defines the required namedtuple objects
+ globally. It also returns a tuple of the classes."""
+ expected_namedtuples = []
+
+ global Star
+ star_attributes = ['spectral_type', 'stellar_effective_temperature', 'stellar_radius', 'stellar_mass', 'stellar_luminosity', 'stellar_surface_gravity', 'stellar_age']
+ Star = namedtuple('Star', star_attributes)
+ expected_namedtuples.append(Star)
+ global Planet
+ planets_attributes = ['planet_name', 'host_name', 'discovery_method', 'discovery_year', 'controversial_flag', 'orbital_period', 'planet_radius', 'planet_mass', 'semi_major_radius', 'eccentricity', 'equilibrium_temperature', 'insolation_flux']
+ Planet = namedtuple('Planet', planets_attributes)
+ expected_namedtuples.append(Planet)
+ return tuple(expected_namedtuples)
+
+_expected_namedtuples = get_expected_namedtuples()
+
+
+def compare_cell_html(expected, actual):
+ """compare_cell_html(expected, actual) is used to compare when the
+ expected answer is a DataFrame stored in the `expected_dfs` html file."""
+ expected_cells = parse_df_html_table(expected)
+ try:
+ actual_cells = parse_df_html_table(BeautifulSoup(actual, 'html.parser').find('table'))
+ except Exception as e:
+ return "expected to find type DataFrame but found type %s instead" % type(actual).__name__
+
+ expected_cols = list(set(["column %s" % (loc[1]) for loc in expected_cells]))
+ actual_cols = list(set(["column %s" % (loc[1]) for loc in actual_cells]))
+ msg = list_compare_unordered(expected_cols, actual_cols, "DataFrame")
+ if msg != PASS:
+ return msg
+
+ expected_rows = list(set(["row index %s" % (loc[0]) for loc in expected_cells]))
+ actual_rows = list(set(["row index %s" % (loc[0]) for loc in actual_cells]))
+ msg = list_compare_unordered(expected_rows, actual_rows, "DataFrame")
+ if msg != PASS:
+ return msg
+
+ for location, expected in expected_cells.items():
+ location_name = "column {} at index {}".format(location[1], location[0])
+ actual = actual_cells.get(location, None)
+ if actual == None:
+ return "in %s, expected to find %s" % (location_name, repr(expected))
+ try:
+ actual_ans = float(actual)
+ expected_ans = float(expected)
+ if math.isnan(actual_ans) and math.isnan(expected_ans):
+ continue
+ except Exception as e:
+ actual_ans, expected_ans = actual, expected
+ msg = simple_compare(expected_ans, actual_ans)
+ if msg != PASS:
+ return "in %s, " % location_name + msg
+ return PASS
+
+
+def get_expected_plots():
+ """get_expected_plots() reads the json file with the expected plot data
+ and returns a dict mapping each question to a dictionary with the plots data."""
+ if not os.path.exists(PLOT_FILE):
+ return None
+
+ f = open(PLOT_FILE, encoding='utf-8')
+ expected_plots = json.load(f)
+ f.close()
+ return expected_plots
+
+
+def compare_file_json(expected, actual):
+ """compare_file_json(expected, actual) is used to compare when the
+ expected answer is a JSON file."""
+ msg = PASS
+ if not os.path.isfile(expected):
+ return "file %s not found; make sure it is downloaded and stored in the correct directory" % (expected)
+ elif not os.path.isfile(actual):
+ return "file %s not found; make sure that you have created the file with the correct name" % (actual)
+ try:
+ e = open(expected, encoding='utf-8')
+ expected_data = json.load(e)
+ e.close()
+ except json.JSONDecodeError:
+ return "file %s is broken and cannot be parsed; please delete and redownload the file correctly" % (expected)
+ try:
+ a = open(actual, encoding='utf-8')
+ actual_data = json.load(a)
+ a.close()
+ except json.JSONDecodeError:
+ return "file %s is broken and cannot be parsed" % (actual)
+ if type(expected_data) == list:
+ msg = list_compare_ordered(expected_data, actual_data, 'file ' + actual)
+ elif type(expected_data) == dict:
+ msg = dict_compare(expected_data, actual_data)
+ return msg
+
+
+_expected_json = get_expected_json()
+_special_json = get_special_json()
+_expected_plots = get_expected_plots()
+_expected_tables = get_expected_tables()
+_expected_format = get_expected_format()
+
+def check(qnum, actual):
+ """check(qnum, actual) is used to check if the answer in the notebook is
+ the correct answer, and provide useful feedback if the answer is incorrect."""
+ msg = PASS
+ error_msg = "<b style='color: red;'>ERROR:</b> "
+ q_format = _expected_format[qnum]
+
+ if q_format == TEXT_FORMAT_SPECIAL_ORDERED_LIST:
+ expected = _special_json[qnum]
+ elif q_format == PNG_FORMAT_SCATTER:
+ if _expected_plots == None:
+ msg = error_msg + "file %s not parsed; make sure it is downloaded and stored in the correct directory" % (PLOT_FILE)
+ else:
+ expected = _expected_plots[qnum]
+ elif q_format == HTML_FORMAT:
+ if _expected_tables == None:
+ msg = error_msg + "file %s not parsed; make sure it is downloaded and stored in the correct directory" % (DF_FILE)
+ else:
+ expected = _expected_tables[qnum]
+ else:
+ expected = _expected_json[qnum]
+
+ if SLASHES in q_format:
+ q_format = q_format.replace(SLASHES, "").strip("_ ")
+ expected = clean_slashes(expected)
+ actual = clean_slashes(actual)
+
+ if msg != PASS:
+ print(msg)
+ else:
+ msg = compare(expected, actual, q_format)
+ if msg != PASS:
+ msg = error_msg + msg
+ print(msg)
+
+
+def check_file_size(path):
+ """check_file_size(path) throws an error if the file is too big to display
+ on Gradescope."""
+ size = os.path.getsize(path)
+ assert size < MAX_FILE_SIZE * 10**3, "Your file is too big to be displayed by Gradescope; please delete unnecessary output cells so your file size is < %s KB" % MAX_FILE_SIZE
+
+
+def reset_hidden_tests():
+ """reset_hidden_tests() resets all hidden tests on the Gradescope autograder where the hidden test file exists"""
+ if not os.path.exists(HIDDEN_FILE):
+ return
+ hidn.reset_hidden_tests()
+
+def rubric_check(rubric_point, ignore_past_errors=True):
+ """rubric_check(rubric_point) uses the hidden test file on the Gradescope autograder to grade the `rubric_point`"""
+ if not os.path.exists(HIDDEN_FILE):
+ print(PASS)
+ return
+ error_msg_1 = "ERROR: "
+ error_msg_2 = "TEST DETAILS: "
+ try:
+ msg = hidn.rubric_check(rubric_point, ignore_past_errors)
+ except:
+ msg = "hidden tests crashed before execution"
+ if msg != PASS:
+ hidn.make_deductions(rubric_point)
+ if msg == "public tests failed":
+ comment = "The public tests have failed, so you will not receive any points for this question."
+ comment += "\nPlease confirm that the public tests pass locally before submitting."
+ elif msg == "answer is hardcoded":
+ comment = "In the datasets for testing hardcoding, all numbers are replaced with random values."
+ comment += "\nIf the answer is the same as in the original dataset for all these datasets"
+ comment += "\ndespite this, that implies that the answer in the notebook is hardcoded."
+ comment += "\nYou will not receive any points for this question."
+ else:
+ comment = hidn.get_comment(rubric_point)
+ msg = error_msg_1 + msg
+ if comment != "":
+ msg = msg + "\n" + error_msg_2 + comment
+ print(msg)
+
+def get_summary():
+ """get_summary() returns the summary of the notebook using the hidden test file on the Gradescope autograder"""
+ if not os.path.exists(HIDDEN_FILE):
+ print("Total Score: %d/%d" % (TOTAL_SCORE, TOTAL_SCORE))
+ return
+ score = min(TOTAL_SCORE, hidn.get_score(TOTAL_SCORE))
+ display_msg = "Total Score: %d/%d" % (score, TOTAL_SCORE)
+ if score != TOTAL_SCORE:
+ display_msg += "\n" + hidn.get_deduction_string()
+ print(display_msg)
+
+def get_score_digit(digit):
+ """get_score_digit(digit) returns the `digit` of the score using the hidden test file on the Gradescope autograder"""
+ if not os.path.exists(HIDDEN_FILE):
+ score = TOTAL_SCORE
+ else:
+ score = hidn.get_score(TOTAL_SCORE)
+ digits = bin(score)[2:]
+ digits = "0"*(7 - len(digits)) + digits
+ return int(digits[6 - digit])
diff --git a/p10/rubric.md b/p10/rubric.md
new file mode 100644
index 0000000..106b674
--- /dev/null
+++ b/p10/rubric.md
@@ -0,0 +1,151 @@
+# Project 10 (P10) grading rubric
+
+## Code reviews
+
+- The Gradescope autograder will make deductions based on the rubric provided below.
+- To ensure that you don't lose any points, you must review the rubric and make sure that you have followed the instructions provided in the project correctly.
+
+## Rubric
+
+### General guidelines:
+
+- Outputs not visible/did not save the notebook file prior to running the cell containing "export". We cannot see your output if you do not save before generating the zip file. (-3)
+- Used concepts/modules such as `csv.DictReader` and `pandas` not covered in class yet. Note that built-in functions that you have been introduced to can be used. (-3)
+- Used bare try/except blocks without explicitly specifying the type of exceptions that need to be caught (-3)
+- Large outputs such as `stars_dict` or `planets_list` are displayed in the notebook. (-3)
+- Import statements are not mentioned in the required cell at the top of the notebook. (-1)
+
+### Question specific guidelines:
+
+- q1 (3)
+ - answer is not sorted explicitly (-2)
+ - answer does not remove all files and directories that start with `.` (-1)
+
+- q2 (3)
+ - recomputed variable defined in Question 1, or the answer is not sorted explicitly (-1)
+ - answer does not remove all files and directories that start with `.` (-1)
+ - paths are hardcoded using slashes (-1)
+
+- q3 (4)
+ - recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly (-1)
+ - answer does not remove all files and directories that start with `.` (-1)
+ - answer does not check only for files that end with `.csv` (-1)
+ - paths are hardcoded using slashes (-1)
+
+- q4 (4)
+ - recomputed variable defined in Question 1 or Question 2, or the answer is not sorted explicitly (-1)
+ - answer does not remove all files and directories that start with `.` (-1)
+ - answer does not check for only files that start with `stars` (-1)
+ - paths are hardcoded using slashes (-1)
+
+- `Star` (2)
+ - data structure is defined more than once (-1)
+ - data structure is defined incorrectly (-1)
+
+- `star_cell` (4)
+ - function does not typecast values based on columns (-1)
+ - column indices are hardcoded instead of using column names (-1)
+ - function logic is incorrect (-1)
+ - function is defined more than once (-1)
+
+- q5 (4)
+ - `star_cell` function is not used to answer (-1)
+ - answer unnecessarily iterates over the entire dataset (-1)
+
+- `get_stars` (6)
+ - function logic is incorrect (-2)
+ - hardcoded the name of directory inside the function instead of passing it as a part of the input argument (-1)
+ - function is called more than twice with the same dataset (-1)
+ - `star_cell` function is not used (-1)
+ - function is defined more than once (-1)
+
+- q6 (2)
+ - `stars_1_dict` data structure is not used to answer (-2)
+
+- q7 (3)
+ - incorrect logic is used to answer (-1)
+ - `stars_1_dict` data structure is not used to answer (-1)
+
+- q8 (3)
+ - incorrect logic is used to answer (-1)
+ - `get_stars` function is not used to answer (-1)
+
+- `stars_dict` (3)
+ - data structure is defined incorrectly (-1)
+ - `get_stars` function is not used (-1)
+ - `stars_paths` is not used to find paths of necessary files (-1)
+
+- q9 (2)
+ - `stars_dict` data structure is not used to answer (-2)
+
+- q10 (3)
+ - incorrect logic is used to answer (-1)
+ - `stars_dict` data structure is not used to answer (-1)
+
+- q11 (3)
+ - answer does not check for only stars that start with `Kepler` (-1)
+ - incorrect logic is used to answer (-1)
+ - `stars_dict` data structure is not used to answer (-1)
+
+- `Planet` (2)
+ - data structure is defined more than once (-1)
+ - data structure is defined incorrectly (-1)
+
+- `planet_cell` (5)
+ - function does not typecast values based on columns (-1)
+ - column indices are hardcoded instead of using column names (-1)
+ - boolean values are not typecasted correctly (-1)
+ - function logic is incorrect (-1)
+ - function is defined more than once (-1)
+
+- q12 (4)
+ - `planet_cell` function is not used to answer (-1)
+ - `mapping_1_json` data structure is not used to answer (-1)
+ - answer unnecessarily iterates over the entire dataset (-1)
+
+- `get_planets` (8)
+ - function logic is incorrect (-2)
+ - hardcoded the name of directory inside the function instead of passing it as a part of the input argument (-1)
+ - function is called more than twice with the same dataset (-1)
+ - `planet_cell` function is not used (-1)
+ - function is defined more than once (-3)
+
+- q13 (3)
+ - `get_planets` function is not used to answer (-1)
+ - paths are hardcoded using slashes (-1)
+
+- q14 (3)
+ - incorrect logic is used to answer (-1)
+ - `get_planets` function is not used to answer (-1)
+ - paths are hardcoded using slashes (-1)
+
+- q15 (3)
+ - `get_planets` function is not used to answer (-1)
+ - paths are hardcoded using slashes (-1)
+
+- `planets_list` (4)
+ - data structure is defined incorrectly (-2)
+ - `get_planets` function is not used (-1)
+ - paths are hardcoded using slashes (-1)
+
+- q16 (2)
+ - `planets_list` data structure is not used to answer (-2)
+
+- q17 (3)
+ - incorrect comparison operator is used (-1)
+ - incorrect logic is used to answer (-1)
+ - `planets_list` data structure is not used to answer (-1)
+
+- q18 (4)
+ - `planets_list` and `stars_dict` data structures are not used to answer (-2)
+ - did not exit loop and instead iterated further after finding the answer (-1)
+
+- q19 (5)
+ - incorrect comparison operator is used (-1)
+ - incorrect logic is used to answer (-1)
+ - `planets_list` and `stars_dict` data structures are not used to answer (-2)
+
+- q20 (5)
+ - answer does not include all Planets that orbit the Star (-1)
+ - incorrect logic is used to answer (-1)
+ - `planets_list` and `stars_dict` data structures are not used to answer (-2)
--
GitLab