From 1e615380545114bbb939aa2f438a6114239d11fb Mon Sep 17 00:00:00 2001 From: robin Date: Sat, 28 Sep 2024 08:00:51 -0400 Subject: [PATCH 1/3] spelling error --- docs/filestore.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/filestore.rst b/docs/filestore.rst index 968a79f9a..e281bcca3 100644 --- a/docs/filestore.rst +++ b/docs/filestore.rst @@ -31,7 +31,7 @@ CSV example: fs = CSVFileStore("example.csv") info = fs.push() - print(info) # to display the URL and Coop uuid of the stored file to use for retriving it later + print(info) # display the URL and Coop uuid of the stored file for retrieving it later Example output: @@ -54,7 +54,7 @@ PDF example: fs = PDFFileStore("top_secret.pdf") info = fs.push() - print(info) # to display the URL and Coop uuid of the stored file to use for retriving it later + print(info) # display the URL and Coop uuid of the stored file for retrieving it later Example output: @@ -77,7 +77,7 @@ PNG example: fs = PNGFileStore("parrot_logo.png") info = fs.push() - print(info) # to display the URL and Coop uuid of the stored file to use for retriving it later + print(info) # display the URL and Coop uuid of the stored file for retrieving it later Example output: From e6962bd17c0c5d3874940f1d40c4f9c723f5ae77 Mon Sep 17 00:00:00 2001 From: robin Date: Tue, 1 Oct 2024 09:47:02 -0400 Subject: [PATCH 2/3] scenarios filestore example nb --- .../scenarios_filestore_example.ipynb | 1254 +++++++++++++++++ 1 file changed, 1254 insertions(+) create mode 100644 docs/notebooks/scenarios_filestore_example.ipynb diff --git a/docs/notebooks/scenarios_filestore_example.ipynb b/docs/notebooks/scenarios_filestore_example.ipynb new file mode 100644 index 000000000..cfdb27565 --- /dev/null +++ b/docs/notebooks/scenarios_filestore_example.ipynb @@ -0,0 +1,1254 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "6557e99a-2dbb-4e81-aa96-2c3d963c65f5", + "metadata": {}, + "source": [ + "# Methods for using data in EDSL surveys\n", + "This notebook provides example [EDSL](https://github.com/expectedparrot/edsl) code for methods for using data with an EDSL survey.\n", + "In the steps below we show how to use the [`FileStore`](https://docs.expectedparrot.com/en/latest/filestore.html) module to upload, share and retrieve data files at the [`Coop`](https://docs.expectedparrot.com/en/latest/coop.html), and then create [`Scenario`](https://docs.expectedparrot.com/en/latest/scenarios.html) objects for the data to use it with a survey.\n", + "\n", + "[EDSL is an open-source library](https://github.com/expectedparrot/edsl) for simulating surveys, experiments and other research with AI agents and large language models. \n", + "Before running the code below, please ensure that you have [installed the EDSL library](https://docs.expectedparrot.com/en/latest/installation.html) and either [activated remote inference](https://docs.expectedparrot.com/en/latest/remote_inference.html) from your [Coop account](https://docs.expectedparrot.com/en/latest/coop.html) or [stored API keys](https://docs.expectedparrot.com/en/latest/api_keys.html) for the language models that you want to use with EDSL. Please also see our [documentation page](https://docs.expectedparrot.com/) for tips and tutorials on getting started using EDSL." + ] + }, + { + "cell_type": "markdown", + "id": "cb603e1d-9b28-41e1-ad04-0dc2ea5f5b41", + "metadata": {}, + "source": [ + "## What is a `Scenario`?\n", + "A `Scenario` is a dictionary of one or more key/value pairs representing data or content to be added to questions; a `ScenarioList` is a list of `Scenario` objects. \n", + "Scenario keys are used as question parameters that get replaced with the values when the scenarios are added to the questions, allowing you to create variants of questions efficiently. Learn more about creating and working with scenarios [here](https://docs.expectedparrot.com/en/latest/scenarios.html) and [here](https://docs.expectedparrot.com/en/latest/notebooks/question_loop_scenarios.html)." + ] + }, + { + "cell_type": "markdown", + "id": "35a21a95-d1e9-4ce9-b427-c72184e3f552", + "metadata": {}, + "source": [ + "## What is the `Coop`?\n", + "[`Coop`](https://docs.expectedparrot.com/en/latest/coop.html) is a platform for creating, storing and sharing LLM-based research. \n", + "It is fully integrated with EDSL, allowing you to post, download and update objects directly from your workspace and at the [Coop web app](https://www.expectedparrot.com/login). \n", + "The Coop also provides access to features for working with EDSL remotely at the Expected Parrot server. \n", + "Learn more about these features in the [remote inference](https://docs.expectedparrot.com/en/latest/remote_inference.html) and [remote caching](https://docs.expectedparrot.com/en/latest/remote_caching.html) sections of the [documentation page](https://docs.expectedparrot.com/)." + ] + }, + { + "cell_type": "markdown", + "id": "bdb593cf-304f-4a74-8669-41227d465b9e", + "metadata": {}, + "source": [ + "## What is the `FileStore`?\n", + "[`FileStore`](https://docs.expectedparrot.com/en/latest/filestore.html) is a module for storing and sharing data at the Coop to use in EDSL projects, such as survey data, PDFs, CSVs or images. \n", + "In particular, it is designed for storing files to be used as as scenarios, and allows you to include code for easily retrieving and processing the files in your EDSL project, as we do in the examples below!" + ] + }, + { + "cell_type": "markdown", + "id": "66424931-600e-464a-95ed-059ddee64881", + "metadata": {}, + "source": [ + "## Example\n", + "In the example below we create scenarios for some data (a table at a Wikipedia page) and inspect them. Then we store the scenarios as a CSV and post it to the Coop using the file store. Then we retrieve the file and recreate the scenarios, and use them in a survey. We also post the survey, results and this notebook to the Coop for reference.\n", + "\n", + "We start by creating importing the tools that we will use:" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "c8a34852-9ba2-41de-985a-d21c2524e9af", + "metadata": {}, + "outputs": [], + "source": [ + "from edsl import ScenarioList, Scenario\n", + "from edsl.scenarios.FileStore import CSVFileStore" + ] + }, + { + "cell_type": "markdown", + "id": "9a9bb7ad-2c7f-4f42-a8e3-d1b91e76f736", + "metadata": {}, + "source": [ + "### Creating a scenario list for a Wikipedia table\n", + "EDSL comes with many methods for automatically [generating `Scenario` objects from various data sources](https://docs.expectedparrot.com/en/latest/scenarios.html), such as PDFs, CSVs, docs, images, lists, dicts, etc.\n", + "Here we use a method to automatically [create a scenario list for a Wikipedia table](https://docs.expectedparrot.com/en/latest/notebooks/scenario_list_wikipedia.html), passing the URL and the number of the table on the page:" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "3c02ee41-abae-4dbd-b6cb-54831b20c5e5", + "metadata": {}, + "outputs": [], + "source": [ + "s = ScenarioList.from_wikipedia(\"https://en.wikipedia.org/wiki/List_of_Billboard_Hot_100_number-one_singles_of_the_1980s\",5)" + ] + }, + { + "cell_type": "markdown", + "id": "c656c3de-7435-41d3-8321-91027b3b1a2d", + "metadata": {}, + "source": [ + "We can inspect the scenario list that has been created:" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "6b5465c9-bf43-4c4f-ac43-df7606b9f692", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n",
+       "┃ Weeks at number one ┃ Song                           ┃ Artist(s)                          ┃\n",
+       "┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n",
+       "│ 10                  │ \"Physical\"                     │ Olivia Newton-John                 │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9                   │ \"Bette Davis Eyes\"             │ Kim Carnes                         │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9                   │ \"Endless Love\"                 │ Diana Ross and Lionel Richie       │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 8                   │ \"Every Breath You Take\"        │ The Police                         │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7                   │ \"I Love Rock 'n' Roll\"         │ Joan Jett and the Blackhearts      │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7                   │ \"Ebony and Ivory\"              │ Paul McCartney and Stevie Wonder   │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7                   │ \"Billie Jean\"                  │ Michael Jackson                    │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Call Me\"                      │ Blondie                            │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Lady\"                         │ Kenny Rogers                       │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Centerfold\"                   │ The J. Geils Band                  │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Eye of the Tiger\"             │ Survivor                           │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Flashdance... What a Feeling\" │ Irene Cara                         │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Say, Say, Say\"                │ Paul McCartney and Michael Jackson │\n",
+       "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6                   │ \"Like a Virgin\"                │ Madonna                            │\n",
+       "└─────────────────────┴────────────────────────────────┴────────────────────────────────────┘\n",
+       "
\n" + ], + "text/plain": [ + "┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35mWeeks at number one\u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35mSong \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35mArtist(s) \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n", + "│\u001b[2m \u001b[0m\u001b[2m10 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Physical\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKim Carnes \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Endless Love\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mDiana Ross and Lionel Richie \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m8 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Every Breath You Take\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe Police \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"I Love Rock 'n' Roll\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJoan Jett and the Blackhearts \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Ebony and Ivory\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Stevie Wonder \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Billie Jean\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Call Me\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Lady\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKenny Rogers \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Centerfold\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe J. Geils Band \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mSurvivor \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Flashdance... What a Feeling\"\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIrene Cara \u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Say, Say, Say\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Michael Jackson\u001b[0m\u001b[2m \u001b[0m│\n", + "├─────────────────────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Like a Virgin\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMadonna \u001b[0m\u001b[2m \u001b[0m│\n", + "└─────────────────────┴────────────────────────────────┴────────────────────────────────────┘\n" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "s.print(format=\"rich\")" + ] + }, + { + "cell_type": "markdown", + "id": "ec95f521-c55f-4d61-9224-6b53d8da96f4", + "metadata": {}, + "source": [ + "We can rename the keys for convenience:" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "fe51f914-a778-4935-a6b6-a535d963eef8", + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'Artist(s)', 'Song', 'Weeks at number one'}" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "s.parameters" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "id": "1f5f33e3-6463-45af-b60f-8a5f9ff766a0", + "metadata": {}, + "outputs": [], + "source": [ + "s = s.rename({'Artist(s)':\"artists\", 'Song':\"song\", 'Weeks at number one':\"weeks\"})" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "ae9b0342-e44a-431c-a710-f3414d82de3d", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n",
+       "┃ weeks ┃ song                           ┃ artists                            ┃\n",
+       "┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n",
+       "│ 10    │ \"Physical\"                     │ Olivia Newton-John                 │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9     │ \"Bette Davis Eyes\"             │ Kim Carnes                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9     │ \"Endless Love\"                 │ Diana Ross and Lionel Richie       │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 8     │ \"Every Breath You Take\"        │ The Police                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"I Love Rock 'n' Roll\"         │ Joan Jett and the Blackhearts      │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"Ebony and Ivory\"              │ Paul McCartney and Stevie Wonder   │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"Billie Jean\"                  │ Michael Jackson                    │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Call Me\"                      │ Blondie                            │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Lady\"                         │ Kenny Rogers                       │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Centerfold\"                   │ The J. Geils Band                  │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Eye of the Tiger\"             │ Survivor                           │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Flashdance... What a Feeling\" │ Irene Cara                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Say, Say, Say\"                │ Paul McCartney and Michael Jackson │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Like a Virgin\"                │ Madonna                            │\n",
+       "└───────┴────────────────────────────────┴────────────────────────────────────┘\n",
+       "
\n" + ], + "text/plain": [ + "┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35mweeks\u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35msong \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35martists \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n", + "│\u001b[2m \u001b[0m\u001b[2m10 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Physical\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKim Carnes \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Endless Love\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mDiana Ross and Lionel Richie \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m8 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Every Breath You Take\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe Police \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"I Love Rock 'n' Roll\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJoan Jett and the Blackhearts \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Ebony and Ivory\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Stevie Wonder \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Billie Jean\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Call Me\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Lady\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKenny Rogers \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Centerfold\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe J. Geils Band \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mSurvivor \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Flashdance... What a Feeling\"\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIrene Cara \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Say, Say, Say\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Michael Jackson\u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Like a Virgin\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMadonna \u001b[0m\u001b[2m \u001b[0m│\n", + "└───────┴────────────────────────────────┴────────────────────────────────────┘\n" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "s.print(format=\"rich\")" + ] + }, + { + "cell_type": "markdown", + "id": "f3091277-b4a8-4c02-85ea-f4ca14a78420", + "metadata": {}, + "source": [ + "We can save the scenarios to a CSV:" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "id": "1d5ad700-75b6-4383-9ac0-882f3d4e2379", + "metadata": {}, + "outputs": [], + "source": [ + "s.to_csv(\"billboard_100_1980s.csv\")" + ] + }, + { + "cell_type": "markdown", + "id": "445931be-d370-48fd-9a7f-386fbfea1861", + "metadata": {}, + "source": [ + "### Storing data at the Coop using the file store\n", + "Here we use the CSV file store to store the file that we just created:" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "id": "56c7a3ed-3bb7-48f5-9fa5-a3d8352149bc", + "metadata": {}, + "outputs": [], + "source": [ + "fs = CSVFileStore(\"billboard_100_1980s.csv\")" + ] + }, + { + "cell_type": "markdown", + "id": "9b145a60-a712-4577-8a01-59158aa4983e", + "metadata": {}, + "source": [ + "We can post a `FileStore` object to the Coop by calling the `push()` method on it.\n", + "We can optionally pass a `description` and a `visibility` setting - *public*, *unlisted* (by default) or *private*:" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "id": "bc8224ee-c998-4595-8aca-76714edbe09e", + "metadata": {}, + "outputs": [], + "source": [ + "info = fs.push(description = \"Wikipedia: List of Billboard Hot 100 number-one singles of the 1980s\")" + ] + }, + { + "cell_type": "markdown", + "id": "c09c446a-d958-401e-8612-121c8f9f9f09", + "metadata": {}, + "source": [ + "We can print the details of the posted object, including the URL and Coop uuid that we will need to retrieve it later:" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "id": "3cf2980f-83ec-45d0-88ae-a419cd2ebf9d", + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'description': 'Wikipedia: List of Billboard Hot 100 number-one singles of the 1980s',\n", + " 'object_type': 'scenario',\n", + " 'url': 'https://www.expectedparrot.com/content/add0b8ee-b127-4b5e-82ad-cd00ddaf2552',\n", + " 'uuid': 'add0b8ee-b127-4b5e-82ad-cd00ddaf2552',\n", + " 'version': '0.1.33',\n", + " 'visibility': 'unlisted'}" + ] + }, + "execution_count": 10, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "info" + ] + }, + { + "cell_type": "markdown", + "id": "174fd745-c357-47c7-8560-c3b174fd5959", + "metadata": {}, + "source": [ + "### Retrieving a file and recreating scenarios\n", + "Here we retrieve the file from the file store and recreate scenarios:" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "id": "b15c5108-6166-4ca4-b244-ddb7b3d6246f", + "metadata": {}, + "outputs": [], + "source": [ + "csv_file = CSVFileStore.pull(\"add0b8ee-b127-4b5e-82ad-cd00ddaf2552\", expected_parrot_url=\"https://www.expectedparrot.com\")" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "id": "e435ef56-1fc7-4f6a-8252-a788f779aeb4", + "metadata": {}, + "outputs": [], + "source": [ + "s = ScenarioList.from_csv(csv_file.to_tempfile())" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "id": "d8910b50-f627-455c-9b3e-1cada77def69", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n",
+       "┃ weeks ┃ song                           ┃ artists                            ┃\n",
+       "┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n",
+       "│ 10    │ \"Physical\"                     │ Olivia Newton-John                 │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9     │ \"Bette Davis Eyes\"             │ Kim Carnes                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 9     │ \"Endless Love\"                 │ Diana Ross and Lionel Richie       │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 8     │ \"Every Breath You Take\"        │ The Police                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"I Love Rock 'n' Roll\"         │ Joan Jett and the Blackhearts      │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"Ebony and Ivory\"              │ Paul McCartney and Stevie Wonder   │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 7     │ \"Billie Jean\"                  │ Michael Jackson                    │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Call Me\"                      │ Blondie                            │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Lady\"                         │ Kenny Rogers                       │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Centerfold\"                   │ The J. Geils Band                  │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Eye of the Tiger\"             │ Survivor                           │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Flashdance... What a Feeling\" │ Irene Cara                         │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Say, Say, Say\"                │ Paul McCartney and Michael Jackson │\n",
+       "├───────┼────────────────────────────────┼────────────────────────────────────┤\n",
+       "│ 6     │ \"Like a Virgin\"                │ Madonna                            │\n",
+       "└───────┴────────────────────────────────┴────────────────────────────────────┘\n",
+       "
\n" + ], + "text/plain": [ + "┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35mweeks\u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35msong \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35martists \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n", + "│\u001b[2m \u001b[0m\u001b[2m10 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Physical\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKim Carnes \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Endless Love\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mDiana Ross and Lionel Richie \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m8 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Every Breath You Take\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe Police \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"I Love Rock 'n' Roll\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJoan Jett and the Blackhearts \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Ebony and Ivory\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Stevie Wonder \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Billie Jean\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Call Me\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Lady\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKenny Rogers \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Centerfold\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe J. Geils Band \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mSurvivor \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Flashdance... What a Feeling\"\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIrene Cara \u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Say, Say, Say\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Michael Jackson\u001b[0m\u001b[2m \u001b[0m│\n", + "├───────┼────────────────────────────────┼────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Like a Virgin\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMadonna \u001b[0m\u001b[2m \u001b[0m│\n", + "└───────┴────────────────────────────────┴────────────────────────────────────┘\n" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "s.print(format=\"rich\")" + ] + }, + { + "cell_type": "markdown", + "id": "dae17cb1-8b12-46b0-a953-aa6f53a3c5f8", + "metadata": {}, + "source": [ + "### Using scenarios in a survey\n" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "id": "700d81c8-5a66-4a98-94c1-2b3c23632963", + "metadata": {}, + "outputs": [], + "source": [ + "from edsl import QuestionFreeText, QuestionMultipleChoice, QuestionCheckBox, QuestionList, Survey\n", + "\n", + "q1 = QuestionFreeText(\n", + " question_name = \"topic\",\n", + " question_text = \"What is the topic of the song {{ song }} by {{ artists }}?\"\n", + ")\n", + "\n", + "q2 = QuestionMultipleChoice(\n", + " question_name = \"sentiment\",\n", + " question_text = \"What is the sentiment of the song {{ song }} by {{ artists }}?\",\n", + " question_options = [\n", + " \"Happy\",\n", + " \"Sad\",\n", + " \"Angry\",\n", + " \"Romantic\",\n", + " \"Nostalgic\",\n", + " \"Empowering\",\n", + " \"Melancholic\",\n", + " \"Hopeful\"\n", + " ]\n", + ")\n", + "\n", + "q3 = QuestionCheckBox(\n", + " question_name = \"themes\",\n", + " question_text = \"What themes are present in the song {{ song }} by {{ artists }}?\",\n", + " question_options = [\n", + " \"Love\",\n", + " \"Loss\",\n", + " \"Struggle\",\n", + " \"Celebration\",\n", + " \"Social issues\",\n", + " \"Other\"\n", + " ]\n", + ")\n", + "\n", + "q4 = QuestionList(\n", + " question_name = \"other_themes\",\n", + " question_text = \"What other themes are present?\"\n", + ")\n", + "\n", + "survey = (\n", + " Survey(questions = [q1, q2, q3, q4])\n", + " .add_targeted_memory(q4, q3)\n", + " .add_stop_rule(q3, \"'Other' not in themes\")\n", + ")\n", + "\n", + "results = survey.by(s).run()" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "id": "3e5530bf-867e-4ab9-9b19-e93b504f8021", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n",
+       "┃ scenario                       ┃ scenario                           ┃ answer                                    ┃\n",
+       "┃ .song                          ┃ .artists                           ┃ .topic                                    ┃\n",
+       "┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n",
+       "│ \"Bette Davis Eyes\"             │ Kim Carnes                         │ \"Bette Davis Eyes\" by Kim Carnes is a     │\n",
+       "│                                │                                    │ song that describes a woman who is        │\n",
+       "│                                │                                    │ captivating, alluring, and somewhat       │\n",
+       "│                                │                                    │ mysterious. The lyrics paint a picture of │\n",
+       "│                                │                                    │ her as someone who has a magnetic charm   │\n",
+       "│                                │                                    │ and a certain allure, much like the       │\n",
+       "│                                │                                    │ iconic actress Bette Davis, known for her │\n",
+       "│                                │                                    │ distinctive eyes and strong screen        │\n",
+       "│                                │                                    │ presence. The song highlights her ability │\n",
+       "│                                │                                    │ to enchant and mesmerize those around her │\n",
+       "│                                │                                    │ with her unique and striking qualities.   │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Billie Jean\"                  │ Michael Jackson                    │ The song \"Billie Jean\" by Michael Jackson │\n",
+       "│                                │                                    │ is about a woman named Billie Jean who    │\n",
+       "│                                │                                    │ claims that the narrator is the father of │\n",
+       "│                                │                                    │ her child, which he denies. The lyrics    │\n",
+       "│                                │                                    │ describe the emotional turmoil and        │\n",
+       "│                                │                                    │ confusion caused by her accusations, as   │\n",
+       "│                                │                                    │ well as the impact on his life and        │\n",
+       "│                                │                                    │ reputation. The song addresses themes of  │\n",
+       "│                                │                                    │ false accusations, infidelity, and the    │\n",
+       "│                                │                                    │ consequences of fame. \"Billie Jean\" is    │\n",
+       "│                                │                                    │ one of Michael Jackson's most famous      │\n",
+       "│                                │                                    │ tracks and is known for its distinctive   │\n",
+       "│                                │                                    │ bassline and compelling narrative.        │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Call Me\"                      │ Blondie                            │ The song \"Call Me\" by Blondie is about a  │\n",
+       "│                                │                                    │ passionate, whirlwind romance and the     │\n",
+       "│                                │                                    │ excitement of a new relationship. The     │\n",
+       "│                                │                                    │ lyrics convey a sense of urgency and      │\n",
+       "│                                │                                    │ desire, with the protagonist inviting     │\n",
+       "│                                │                                    │ their lover to call them anytime, day or  │\n",
+       "│                                │                                    │ night. The song captures the intensity    │\n",
+       "│                                │                                    │ and immediacy of falling in love and the  │\n",
+       "│                                │                                    │ thrill of a deep, emotional connection.   │\n",
+       "│                                │                                    │ It was released in 1980 and became one of │\n",
+       "│                                │                                    │ Blondie's biggest hits, known for its     │\n",
+       "│                                │                                    │ energetic beat and catchy chorus.         │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Centerfold\"                   │ The J. Geils Band                  │ The song \"Centerfold\" by The J. Geils     │\n",
+       "│                                │                                    │ Band, released in 1981, is about a man    │\n",
+       "│                                │                                    │ who is shocked to discover that a girl he │\n",
+       "│                                │                                    │ had a crush on in high school has become  │\n",
+       "│                                │                                    │ a centerfold model in an adult magazine.  │\n",
+       "│                                │                                    │ The lyrics describe his mixed emotions of │\n",
+       "│                                │                                    │ surprise, nostalgia, and disillusionment  │\n",
+       "│                                │                                    │ as he grapples with the image of the girl │\n",
+       "│                                │                                    │ he once admired now being portrayed in a  │\n",
+       "│                                │                                    │ provocative manner. The song combines     │\n",
+       "│                                │                                    │ these themes with a catchy, upbeat        │\n",
+       "│                                │                                    │ melody, making it a memorable hit from    │\n",
+       "│                                │                                    │ the early '80s.                           │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Ebony and Ivory\"              │ Paul McCartney and Stevie Wonder   │ The song \"Ebony and Ivory\" by Paul        │\n",
+       "│                                │                                    │ McCartney and Stevie Wonder addresses     │\n",
+       "│                                │                                    │ themes of racial harmony and unity. The   │\n",
+       "│                                │                                    │ title metaphorically refers to the black  │\n",
+       "│                                │                                    │ and white keys on a piano, symbolizing    │\n",
+       "│                                │                                    │ how different races can come together to  │\n",
+       "│                                │                                    │ create something beautiful. The lyrics    │\n",
+       "│                                │                                    │ emphasize the importance of living        │\n",
+       "│                                │                                    │ together in perfect harmony, despite      │\n",
+       "│                                │                                    │ differences, and promoting mutual         │\n",
+       "│                                │                                    │ understanding and cooperation.            │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Endless Love\"                 │ Diana Ross and Lionel Richie       │ The song \"Endless Love\" by Diana Ross and │\n",
+       "│                                │                                    │ Lionel Richie is about a deep, unwavering │\n",
+       "│                                │                                    │ romantic love between two people. The     │\n",
+       "│                                │                                    │ lyrics express a profound and enduring    │\n",
+       "│                                │                                    │ affection, with the singers declaring     │\n",
+       "│                                │                                    │ their eternal devotion and commitment to  │\n",
+       "│                                │                                    │ each other. It's a classic love ballad    │\n",
+       "│                                │                                    │ that celebrates the timeless and          │\n",
+       "│                                │                                    │ unbreakable bond between lovers.          │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Every Breath You Take\"        │ The Police                         │ The song \"Every Breath You Take\" by The   │\n",
+       "│                                │                                    │ Police, released in 1983, is often        │\n",
+       "│                                │                                    │ interpreted as a love song due to its     │\n",
+       "│                                │                                    │ mellow and melodic tune. However, the     │\n",
+       "│                                │                                    │ lyrics reveal a much darker theme. The    │\n",
+       "│                                │                                    │ song is about obsession and surveillance, │\n",
+       "│                                │                                    │ with the narrator expressing an intense   │\n",
+       "│                                │                                    │ fixation on someone, watching their every │\n",
+       "│                                │                                    │ move. Phrases like \"Every breath you      │\n",
+       "│                                │                                    │ take, every move you make, I'll be        │\n",
+       "│                                │                                    │ watching you\" suggest a sense of          │\n",
+       "│                                │                                    │ possessiveness and control rather than    │\n",
+       "│                                │                                    │ romantic love. The song has been widely   │\n",
+       "│                                │                                    │ discussed and analyzed for its portrayal  │\n",
+       "│                                │                                    │ of unhealthy obsession masked by a        │\n",
+       "│                                │                                    │ seemingly gentle melody.                  │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Eye of the Tiger\"             │ Survivor                           │ \"Eye of the Tiger\" by Survivor is a song  │\n",
+       "│                                │                                    │ about perseverance, determination, and    │\n",
+       "│                                │                                    │ fighting spirit. It was famously used as  │\n",
+       "│                                │                                    │ the theme song for the movie \"Rocky III,\" │\n",
+       "│                                │                                    │ and its lyrics convey the idea of rising  │\n",
+       "│                                │                                    │ up to challenges, staying focused, and    │\n",
+       "│                                │                                    │ maintaining the will to succeed despite   │\n",
+       "│                                │                                    │ obstacles. The \"eye of the tiger\"         │\n",
+       "│                                │                                    │ metaphor represents a sharp, unyielding   │\n",
+       "│                                │                                    │ focus and readiness to face and overcome  │\n",
+       "│                                │                                    │ adversity.                                │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Flashdance... What a Feeling\" │ Irene Cara                         │ The song \"Flashdance... What a Feeling\"   │\n",
+       "│                                │                                    │ by Irene Cara is about the exhilaration   │\n",
+       "│                                │                                    │ and fulfillment that comes from pursuing  │\n",
+       "│                                │                                    │ one's dreams with passion and             │\n",
+       "│                                │                                    │ determination. The lyrics convey a sense  │\n",
+       "│                                │                                    │ of empowerment and the joy of achieving   │\n",
+       "│                                │                                    │ one's goals, capturing the essence of     │\n",
+       "│                                │                                    │ following one's heart and experiencing    │\n",
+       "│                                │                                    │ the euphoria that comes with realizing    │\n",
+       "│                                │                                    │ one's ambitions. The song was prominently │\n",
+       "│                                │                                    │ featured in the 1983 film \"Flashdance,\"   │\n",
+       "│                                │                                    │ which tells the story of a young woman    │\n",
+       "│                                │                                    │ aspiring to become a professional dancer. │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"I Love Rock 'n' Roll\"         │ Joan Jett and the Blackhearts      │ The song \"I Love Rock 'n' Roll\" by Joan   │\n",
+       "│                                │                                    │ Jett and the Blackhearts is about the     │\n",
+       "│                                │                                    │ excitement and passion for rock and roll  │\n",
+       "│                                │                                    │ music. The lyrics describe a scene where  │\n",
+       "│                                │                                    │ the narrator spots someone attractive at  │\n",
+       "│                                │                                    │ a jukebox, and they bond over their       │\n",
+       "│                                │                                    │ shared love for rock music. The song      │\n",
+       "│                                │                                    │ captures the rebellious and energetic     │\n",
+       "│                                │                                    │ spirit of rock and roll, emphasizing how  │\n",
+       "│                                │                                    │ it brings people together and creates a   │\n",
+       "│                                │                                    │ sense of fun and freedom.                 │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Lady\"                         │ Kenny Rogers                       │ The song \"Lady\" by Kenny Rogers is a      │\n",
+       "│                                │                                    │ romantic ballad that expresses deep love  │\n",
+       "│                                │                                    │ and devotion. Written by Lionel Richie,   │\n",
+       "│                                │                                    │ the song's lyrics convey a man's          │\n",
+       "│                                │                                    │ heartfelt emotions and admiration for the │\n",
+       "│                                │                                    │ woman he loves. He describes her as the   │\n",
+       "│                                │                                    │ light in his life, his inspiration, and   │\n",
+       "│                                │                                    │ someone who has filled his life with joy  │\n",
+       "│                                │                                    │ and meaning. The song is celebrated for   │\n",
+       "│                                │                                    │ its tender and sincere portrayal of love  │\n",
+       "│                                │                                    │ and commitment.                           │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Like a Virgin\"                │ Madonna                            │ The song \"Like a Virgin\" by Madonna,      │\n",
+       "│                                │                                    │ released in 1984, is about the feeling of │\n",
+       "│                                │                                    │ starting fresh in a new romantic          │\n",
+       "│                                │                                    │ relationship. The lyrics describe the     │\n",
+       "│                                │                                    │ excitement and emotional renewal that     │\n",
+       "│                                │                                    │ come with falling in love again after     │\n",
+       "│                                │                                    │ experiencing past relationships. The      │\n",
+       "│                                │                                    │ metaphor of feeling \"like a virgin\"       │\n",
+       "│                                │                                    │ suggests a sense of purity and newness,   │\n",
+       "│                                │                                    │ as if experiencing love for the first     │\n",
+       "│                                │                                    │ time. The song's catchy melody and        │\n",
+       "│                                │                                    │ provocative theme contributed to its      │\n",
+       "│                                │                                    │ widespread popularity and iconic status   │\n",
+       "│                                │                                    │ in pop music.                             │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Physical\"                     │ Olivia Newton-John                 │ The song \"Physical\" by Olivia             │\n",
+       "│                                │                                    │ Newton-John, released in 1981, is         │\n",
+       "│                                │                                    │ primarily about physical attraction and   │\n",
+       "│                                │                                    │ desire. The lyrics suggest a strong,      │\n",
+       "│                                │                                    │ almost irresistible urge to engage in     │\n",
+       "│                                │                                    │ physical intimacy. The song's upbeat      │\n",
+       "│                                │                                    │ tempo and catchy melody complement its    │\n",
+       "│                                │                                    │ playful and somewhat provocative theme.   │\n",
+       "│                                │                                    │ When it was released, \"Physical\" was      │\n",
+       "│                                │                                    │ considered quite bold and even            │\n",
+       "│                                │                                    │ controversial due to its overt references │\n",
+       "│                                │                                    │ to physical relationships. Despite or     │\n",
+       "│                                │                                    │ perhaps because of this, it became one of │\n",
+       "│                                │                                    │ Olivia Newton-John's most successful      │\n",
+       "│                                │                                    │ hits, topping charts and becoming an      │\n",
+       "│                                │                                    │ iconic song of the early 1980s.           │\n",
+       "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n",
+       "│ \"Say, Say, Say\"                │ Paul McCartney and Michael Jackson │ The song \"Say, Say, Say\" by Paul          │\n",
+       "│                                │                                    │ McCartney and Michael Jackson primarily   │\n",
+       "│                                │                                    │ revolves around themes of love and        │\n",
+       "│                                │                                    │ longing. The lyrics depict a conversation │\n",
+       "│                                │                                    │ between two people, with one expressing   │\n",
+       "│                                │                                    │ their feelings and pleading for the       │\n",
+       "│                                │                                    │ other's affection and attention. The song │\n",
+       "│                                │                                    │ explores the emotional dynamics of a      │\n",
+       "│                                │                                    │ romantic relationship, with the singers   │\n",
+       "│                                │                                    │ conveying their desires and the           │\n",
+       "│                                │                                    │ challenges they face in trying to win     │\n",
+       "│                                │                                    │ over the object of their affection.       │\n",
+       "└────────────────────────────────┴────────────────────────────────────┴───────────────────────────────────────────┘\n",
+       "
\n" + ], + "text/plain": [ + "┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35mscenario \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35mscenario \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35manswer \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35m.song \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.artists \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.topic \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKim Carnes \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" by Kim Carnes is a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msong that describes a woman who is \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mcaptivating, alluring, and somewhat \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmysterious. The lyrics paint a picture of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mher as someone who has a magnetic charm \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand a certain allure, much like the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2miconic actress Bette Davis, known for her\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdistinctive eyes and strong screen \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mpresence. The song highlights her ability\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mto enchant and mesmerize those around her\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwith her unique and striking qualities. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Billie Jean\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Billie Jean\" by Michael Jackson\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mis about a woman named Billie Jean who \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mclaims that the narrator is the father of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mher child, which he denies. The lyrics \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdescribe the emotional turmoil and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mconfusion caused by her accusations, as \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwell as the impact on his life and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mreputation. The song addresses themes of \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfalse accusations, infidelity, and the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mconsequences of fame. \"Billie Jean\" is \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mone of Michael Jackson's most famous \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtracks and is known for its distinctive \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mbassline and compelling narrative. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Call Me\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Call Me\" by Blondie is about a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mpassionate, whirlwind romance and the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mexcitement of a new relationship. The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mlyrics convey a sense of urgency and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdesire, with the protagonist inviting \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtheir lover to call them anytime, day or \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mnight. The song captures the intensity \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand immediacy of falling in love and the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthrill of a deep, emotional connection. \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIt was released in 1980 and became one of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie's biggest hits, known for its \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2menergetic beat and catchy chorus. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Centerfold\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe J. Geils Band \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Centerfold\" by The J. Geils \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBand, released in 1981, is about a man \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwho is shocked to discover that a girl he\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mhad a crush on in high school has become \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2ma centerfold model in an adult magazine. \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe lyrics describe his mixed emotions of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msurprise, nostalgia, and disillusionment \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mas he grapples with the image of the girl\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mhe once admired now being portrayed in a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mprovocative manner. The song combines \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthese themes with a catchy, upbeat \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmelody, making it a memorable hit from \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthe early '80s. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Ebony and Ivory\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Stevie Wonder \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Ebony and Ivory\" by Paul \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMcCartney and Stevie Wonder addresses \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthemes of racial harmony and unity. The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtitle metaphorically refers to the black \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand white keys on a piano, symbolizing \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mhow different races can come together to \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mcreate something beautiful. The lyrics \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2memphasize the importance of living \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtogether in perfect harmony, despite \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdifferences, and promoting mutual \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2munderstanding and cooperation. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Endless Love\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mDiana Ross and Lionel Richie \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Endless Love\" by Diana Ross and\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mLionel Richie is about a deep, unwavering\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mromantic love between two people. The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mlyrics express a profound and enduring \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2maffection, with the singers declaring \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtheir eternal devotion and commitment to \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2meach other. It's a classic love ballad \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthat celebrates the timeless and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2munbreakable bond between lovers. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Every Breath You Take\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe Police \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Every Breath You Take\" by The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPolice, released in 1983, is often \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2minterpreted as a love song due to its \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmellow and melodic tune. However, the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mlyrics reveal a much darker theme. The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msong is about obsession and surveillance,\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwith the narrator expressing an intense \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfixation on someone, watching their every\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmove. Phrases like \"Every breath you \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtake, every move you make, I'll be \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwatching you\" suggest a sense of \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mpossessiveness and control rather than \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mromantic love. The song has been widely \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdiscussed and analyzed for its portrayal \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mof unhealthy obsession masked by a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mseemingly gentle melody. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mSurvivor \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" by Survivor is a song \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mabout perseverance, determination, and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfighting spirit. It was famously used as \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthe theme song for the movie \"Rocky III,\"\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand its lyrics convey the idea of rising \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mup to challenges, staying focused, and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmaintaining the will to succeed despite \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mobstacles. The \"eye of the tiger\" \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmetaphor represents a sharp, unyielding \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfocus and readiness to face and overcome \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2madversity. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Flashdance... What a Feeling\"\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIrene Cara \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Flashdance... What a Feeling\" \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mby Irene Cara is about the exhilaration \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand fulfillment that comes from pursuing \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mone's dreams with passion and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdetermination. The lyrics convey a sense \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mof empowerment and the joy of achieving \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mone's goals, capturing the essence of \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfollowing one's heart and experiencing \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthe euphoria that comes with realizing \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mone's ambitions. The song was prominently\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mfeatured in the 1983 film \"Flashdance,\" \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwhich tells the story of a young woman \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2maspiring to become a professional dancer.\u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"I Love Rock 'n' Roll\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJoan Jett and the Blackhearts \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"I Love Rock 'n' Roll\" by Joan \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJett and the Blackhearts is about the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mexcitement and passion for rock and roll \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmusic. The lyrics describe a scene where \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthe narrator spots someone attractive at \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2ma jukebox, and they bond over their \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mshared love for rock music. The song \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mcaptures the rebellious and energetic \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mspirit of rock and roll, emphasizing how \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mit brings people together and creates a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msense of fun and freedom. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Lady\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKenny Rogers \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Lady\" by Kenny Rogers is a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mromantic ballad that expresses deep love \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand devotion. Written by Lionel Richie, \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mthe song's lyrics convey a man's \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mheartfelt emotions and admiration for the\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwoman he loves. He describes her as the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mlight in his life, his inspiration, and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msomeone who has filled his life with joy \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand meaning. The song is celebrated for \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mits tender and sincere portrayal of love \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mand commitment. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Like a Virgin\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMadonna \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Like a Virgin\" by Madonna, \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mreleased in 1984, is about the feeling of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mstarting fresh in a new romantic \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mrelationship. The lyrics describe the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mexcitement and emotional renewal that \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mcome with falling in love again after \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mexperiencing past relationships. The \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mmetaphor of feeling \"like a virgin\" \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2msuggests a sense of purity and newness, \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mas if experiencing love for the first \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtime. The song's catchy melody and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mprovocative theme contributed to its \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mwidespread popularity and iconic status \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2min pop music. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Physical\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Physical\" by Olivia \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNewton-John, released in 1981, is \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mprimarily about physical attraction and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mdesire. The lyrics suggest a strong, \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2malmost irresistible urge to engage in \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mphysical intimacy. The song's upbeat \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtempo and catchy melody complement its \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mplayful and somewhat provocative theme. \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mWhen it was released, \"Physical\" was \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mconsidered quite bold and even \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mcontroversial due to its overt references\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mto physical relationships. Despite or \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mperhaps because of this, it became one of\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John's most successful \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mhits, topping charts and becoming an \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2miconic song of the early 1980s. \u001b[0m\u001b[2m \u001b[0m│\n", + "├────────────────────────────────┼────────────────────────────────────┼───────────────────────────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m\"Say, Say, Say\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and Michael Jackson\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe song \"Say, Say, Say\" by Paul \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMcCartney and Michael Jackson primarily \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mrevolves around themes of love and \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mlonging. The lyrics depict a conversation\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mbetween two people, with one expressing \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mtheir feelings and pleading for the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mother's affection and attention. The song\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mexplores the emotional dynamics of a \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mromantic relationship, with the singers \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mconveying their desires and the \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mchallenges they face in trying to win \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mover the object of their affection. \u001b[0m\u001b[2m \u001b[0m│\n", + "└────────────────────────────────┴────────────────────────────────────┴───────────────────────────────────────────┘\n" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "results.sort_by(\"song\").select(\"song\", \"artists\", \"topic\").print(format=\"rich\")" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "id": "7d568fed-cd4b-4d1b-a35b-fcb01f028a2e", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "
┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓\n",
+       "┃ scenario ┃ scenario            ┃ scenario            ┃ answer      ┃ answer               ┃ answer              ┃\n",
+       "┃ .weeks   ┃ .song               ┃ .artists            ┃ .sentiment  ┃ .themes              ┃ .other_themes       ┃\n",
+       "┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩\n",
+       "│ 10       │ \"Physical\"          │ Olivia Newton-John  │ Happy       │ ['Love', 'Other']    │ ['Desire',          │\n",
+       "│          │                     │                     │             │                      │ 'Seduction',        │\n",
+       "│          │                     │                     │             │                      │ 'Empowerment',      │\n",
+       "│          │                     │                     │             │                      │ 'Fun', 'Exercise']  │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 9        │ \"Endless Love\"      │ Diana Ross and      │ Romantic    │ ['Love']             │ None                │\n",
+       "│          │                     │ Lionel Richie       │             │                      │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 9        │ \"Bette Davis Eyes\"  │ Kim Carnes          │ Nostalgic   │ ['Love', 'Other']    │ ['Manipulation',    │\n",
+       "│          │                     │                     │             │                      │ 'Seduction',        │\n",
+       "│          │                     │                     │             │                      │ 'Mystery', 'Power', │\n",
+       "│          │                     │                     │             │                      │ 'Intrigue']         │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 8        │ \"Every Breath You   │ The Police          │ Melancholic │ ['Love', 'Loss',     │ ['Obsession',       │\n",
+       "│          │ Take\"               │                     │             │ 'Struggle', 'Other'] │ 'Surveillance',     │\n",
+       "│          │                     │                     │             │                      │ 'Loneliness',       │\n",
+       "│          │                     │                     │             │                      │ 'Control']          │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 7        │ \"I Love Rock 'n'    │ Joan Jett and the   │ Empowering  │ ['Love',             │ None                │\n",
+       "│          │ Roll\"               │ Blackhearts         │             │ 'Celebration']       │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 7        │ \"Ebony and Ivory\"   │ Paul McCartney and  │ Hopeful     │ ['Love', 'Social     │ None                │\n",
+       "│          │                     │ Stevie Wonder       │             │ issues']             │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 7        │ \"Billie Jean\"       │ Michael Jackson     │ Melancholic │ ['Love', 'Struggle', │ ['Deception',       │\n",
+       "│          │                     │                     │             │ 'Other']             │ 'Guilt', 'Fame',    │\n",
+       "│          │                     │                     │             │                      │ 'Responsibility']   │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Call Me\"           │ Blondie             │ Romantic    │ ['Love',             │ None                │\n",
+       "│          │                     │                     │             │ 'Celebration']       │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Lady\"              │ Kenny Rogers        │ Romantic    │ ['Love']             │ None                │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Centerfold\"        │ The J. Geils Band   │ Nostalgic   │ ['Love', 'Loss']     │ None                │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Eye of the Tiger\"  │ Survivor            │ Empowering  │ ['Struggle']         │ None                │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Flashdance... What │ Irene Cara          │ Empowering  │ ['Struggle',         │ None                │\n",
+       "│          │ a Feeling\"          │                     │             │ 'Celebration']       │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Say, Say, Say\"     │ Paul McCartney and  │ Romantic    │ ['Love', 'Struggle'] │ None                │\n",
+       "│          │                     │ Michael Jackson     │             │                      │                     │\n",
+       "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n",
+       "│ 6        │ \"Like a Virgin\"     │ Madonna             │ Romantic    │ ['Love',             │ None                │\n",
+       "│          │                     │                     │             │ 'Celebration']       │                     │\n",
+       "└──────────┴─────────────────────┴─────────────────────┴─────────────┴──────────────────────┴─────────────────────┘\n",
+       "
\n" + ], + "text/plain": [ + "┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35mscenario\u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35mscenario \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35mscenario \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35manswer \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35manswer \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35manswer \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┃\u001b[1;35m \u001b[0m\u001b[1;35m.weeks \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.song \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.artists \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.sentiment \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.themes \u001b[0m\u001b[1;35m \u001b[0m┃\u001b[1;35m \u001b[0m\u001b[1;35m.other_themes \u001b[0m\u001b[1;35m \u001b[0m┃\n", + "┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩\n", + "│\u001b[2m \u001b[0m\u001b[2m10 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Physical\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mOlivia Newton-John \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mHappy \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Other'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Desire', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Seduction', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Empowerment', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Fun', 'Exercise'] \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Endless Love\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mDiana Ross and \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRomantic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mLionel Richie \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m9 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Bette Davis Eyes\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKim Carnes \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNostalgic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Other'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Manipulation', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Seduction', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Mystery', 'Power',\u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Intrigue'] \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m8 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Every Breath You \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe Police \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMelancholic\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Loss', \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Obsession', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mTake\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Struggle', 'Other']\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Surveillance', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Loneliness', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Control'] \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"I Love Rock 'n' \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mJoan Jett and the \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mEmpowering \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRoll\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlackhearts \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Celebration'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Ebony and Ivory\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mHopeful \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Social \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mStevie Wonder \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2missues'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m7 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Billie Jean\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMelancholic\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Struggle',\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Deception', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Other'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Guilt', 'Fame', \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Responsibility'] \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Call Me\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mBlondie \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRomantic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Celebration'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Lady\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mKenny Rogers \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRomantic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Centerfold\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mThe J. Geils Band \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNostalgic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Loss'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Eye of the Tiger\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mSurvivor \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mEmpowering \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Struggle'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Flashdance... What\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mIrene Cara \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mEmpowering \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Struggle', \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2ma Feeling\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Celebration'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Say, Say, Say\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mPaul McCartney and \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRomantic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', 'Struggle']\u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMichael Jackson \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "├──────────┼─────────────────────┼─────────────────────┼─────────────┼──────────────────────┼─────────────────────┤\n", + "│\u001b[2m \u001b[0m\u001b[2m6 \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m\"Like a Virgin\" \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mMadonna \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mRomantic \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m['Love', \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2mNone \u001b[0m\u001b[2m \u001b[0m│\n", + "│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\u001b[2m \u001b[0m\u001b[2m'Celebration'] \u001b[0m\u001b[2m \u001b[0m│\u001b[2m \u001b[0m│\n", + "└──────────┴─────────────────────┴─────────────────────┴─────────────┴──────────────────────┴─────────────────────┘\n" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "results.sort_by(\"weeks\", reverse=True).select(\"weeks\", \"song\", \"artists\", \"sentiment\", \"themes\", \"other_themes\").print(format=\"rich\")" + ] + }, + { + "cell_type": "markdown", + "id": "0fdb9da9-ddb7-495d-bb1a-7e42962c5916", + "metadata": {}, + "source": [ + "### Posting a notebook to the Coop\n", + "Here we post the contents of this notebook to the Coop for anyone to access:" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "id": "026de29e-1ed9-4f4d-bb72-480949dd5346", + "metadata": { + "editable": true, + "slideshow": { + "slide_type": "" + }, + "tags": [ + "skip-execution" + ] + }, + "outputs": [], + "source": [ + "from edsl import Notebook" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "id": "4293fd0c-d7ab-4b0b-b604-e3fadb965033", + "metadata": { + "editable": true, + "slideshow": { + "slide_type": "" + }, + "tags": [ + "skip-execution" + ] + }, + "outputs": [], + "source": [ + "n = Notebook(path = \"scenarios_filestore_example.ipynb\")" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "id": "b7698b07-9e43-4beb-abc5-c9764750eabf", + "metadata": { + "editable": true, + "slideshow": { + "slide_type": "" + }, + "tags": [ + "skip-execution" + ] + }, + "outputs": [ + { + "data": { + "text/plain": [ + "{'description': 'Example code for using data files for scenarios via file store and Coop',\n", + " 'object_type': 'notebook',\n", + " 'url': 'https://www.expectedparrot.com/content/0b0c86b4-7629-428c-8346-03d69a6a76f9',\n", + " 'uuid': '0b0c86b4-7629-428c-8346-03d69a6a76f9',\n", + " 'version': '0.1.33',\n", + " 'visibility': 'public'}" + ] + }, + "execution_count": 19, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "n.push(description = \"Example code for using data files for scenarios via file store and Coop\", visibility = \"public\")" + ] + }, + { + "cell_type": "markdown", + "id": "f1060fe4-7ca2-4afe-85ed-e639da7f4c40", + "metadata": {}, + "source": [ + "To update an object:" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "id": "15ba638f-eb63-4d70-a6fa-c43aa486bdb1", + "metadata": { + "editable": true, + "slideshow": { + "slide_type": "" + }, + "tags": [ + "skip-execution" + ] + }, + "outputs": [], + "source": [ + "n = Notebook(path = \"scenarios_filestore_example.ipynb\") # resave" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "id": "29ba613e-7245-4500-bbd0-8f138e973953", + "metadata": { + "editable": true, + "slideshow": { + "slide_type": "" + }, + "tags": [ + "skip-execution" + ] + }, + "outputs": [ + { + "data": { + "text/plain": [ + "{'status': 'success'}" + ] + }, + "execution_count": 21, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "n.patch(uuid = \"0b0c86b4-7629-428c-8346-03d69a6a76f9\", value = n)" + ] + } + ], + "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.7" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} From 009ad14168ea7ebc59064731dcacba7adfd92497 Mon Sep 17 00:00:00 2001 From: robin Date: Tue, 1 Oct 2024 09:49:56 -0400 Subject: [PATCH 3/3] updating index --- docs/index.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/index.rst b/docs/index.rst index bc8dc59cd..e90073fef 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -46,11 +46,13 @@ Technical Setup - Create a :ref:`coop` to create, store and share content on the Expected Parrot server. - :ref:`api_keys`: (*Optional*) Instructions for storing API keys for language models to use EDSL locally. + Getting Started --------------- - :ref:`starter_tutorial`: A tutorial to help you get started using EDSL. + Core Concepts ------------- @@ -60,6 +62,7 @@ Core Concepts - :ref:`agents`: Design and implement AI agents to respond to surveys. - :ref:`language_models`: Select language models to generate results. + Working with Results -------------------- @@ -68,6 +71,7 @@ Working with Results - :ref:`exceptions`: Identify and handle exceptions in your survey design. - :ref:`token_usage`: Manage token limits for language models, and monitor and reduce token usage as desired. + Coop ---- @@ -78,6 +82,7 @@ Coop is a platform for creating, storing and sharing EDSL content and AI researc - :ref:`remote_inference`: Use remote inference to run jobs on the Expected Parrot server. - :ref:`notebooks`: Instructions for sharing `.ipynb` files with other users at the Coop. + Importing Data -------------- @@ -88,6 +93,7 @@ Importing Data * Extend your results with new questions and surveys * Store and share your data on the Coop + How-to Guides ------------- @@ -98,12 +104,14 @@ Examples of special methods and use cases for EDSL, including: * Dynamic agent traits * Creating new methods + Notebooks --------- Templates and example code for using EDSL to conduct different kinds of research. *We're happy to create a new notebook for your use case!* + Developers ---------- @@ -180,6 +188,7 @@ Information about additional functionality for developers. notebooks/image_scenario_example.ipynb notebooks/question_loop_scenario.ipynb notebooks/scenario_list_wikipedia.ipynb + notebooks/scenarios_filestore_example.ipynb notebooks/batching_results.ipynb notebooks/adding_metadata.ipynb notebooks/example_agent_dynamic_traits.ipynb