Skip to main content

Python library for solving the McKinsey Solve Game

Project description

McKinsey Solve Game

This Python package helps solving the Ecosystem Building game from the McKinsey Solve Game. In this game, you need to find a sustainable chain of 8 species among many species (39 in total).

This package provides a function called find_sustainable_food_chain, which takes a list of species as input and returns a solution that optimizes the creation of sustainable food chains, maximizing the count of species involved.

Rules of the Game

A set of 39 species is given. From this set, you need to build a sustainable food chain. Species are divided into producers and animals. Producers do not need calories to survive and consume only natural resources. Animals consume other animals and producers and need calories to survive. Animals follow the following rules:

  • The species with the highest calories provided eats first.
  • It eats the species providing the highest calories provided as a food source. In case of a tie, it will eat half from each of the two species with the same calories.
  • Eating consumes calories from the food source by the amount needed by the predator. You need calories provided greater than zero for a species to survive and all calories needed equal to zero after they eat.

If a species does not get enough calories or reaches zero with its own calories provided, the food chain is not sustainable.

Installation

To install mckinseysolvegame, simply use pip:

pip install mckinseysolvegame

Usage

Define the input species

from mckinseysolvegame import Species

my_species = [
    Species(name="Widgeon Grass",
            calories_provided=4950,
            calories_needed=0,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[]),
    Species(name="Fire Coral",
            calories_provided=5850,
            calories_needed=0,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[]),
    Species(name="Common Eel Grass",
            calories_provided=4950,
            calories_needed=0,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[]),
    Species(name="Yellow Tube Sponge",
            calories_provided=4600,
            calories_needed=0,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[]),
    Species(name="Green Zoanthid",
            calories_provided=5050,
            calories_needed=0,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[]),
    Species(name="Peacock's Tail Algae",
            calories_provided=4100,
            calories_needed=0,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[]),
    Species(name="Stalked Kelp",
            calories_provided=4650,
            calories_needed=0,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[]),
    Species(name="Rock Weed",
            calories_provided=4600,
            calories_needed=0,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[]),
    Species(name="Purple Hydrocoral",
            calories_provided=5600,
            calories_needed=0,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[]),
    Species(name="Blue Striped Angelfish",
            calories_provided=3750,
            calories_needed=4550,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=["Common Eel Grass"]),
    Species(name="Blue Shark",
            calories_provided=4650,
            calories_needed=2150,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Bicolour Angelfish",
                "Majestic Angelfish",
                "Northern Red Snapper",
                "Coral Trout",
                "Swordfish",
                "Sailfin Tang",
                "Powder Blue Tang",
                "Flame Angelfish",
                "Eyestripe Surgeonfish"
                ]),
    Species(name="Bicolour Angelfish",
            calories_provided=1900,
            calories_needed=440,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Powder Blue Tang",
                "Flame Angelfish",
                "Eyestripe Surgeonfish",
                "Stalked Kelp",
                "Purple Hydrocoral"
                ]),
    Species(name="Bicolour Parrotfish",
            calories_provided=3400,
            calories_needed=8800,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Widgeon Grass",
                "Common Eel Grass",
                "Fire Coral"
                ]),
    Species(name="Wahoo",
            calories_provided=1700,
            calories_needed=2500,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Short-tail Stingray",
                "Blue Striped Angelfish"
                ]),
    Species(name="Swordfish",
            calories_provided=2000,
            calories_needed=500,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Bicolour Angelfish"
                ]),
    Species(name="Short-tail Stingray",
            calories_provided=1450,
            calories_needed=2050,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Common Dolphinfish",
                "Foxface Rabbitfish"
                ]),
    Species(name="Sailfin Tang",
            calories_provided=2500,
            calories_needed=4800,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Rock Weed"
                ]),
    Species(name="Queen Parrotfish",
            calories_provided=3800,
            calories_needed=4700,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=["Fire Coral"]),
    Species(name="Queen Angelfish",
            calories_provided=2600,
            calories_needed=3100,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Blue Striped Angelfish",
                "Queen Parrotfish",
                "Common Eel Grass"
                ]),
    Species(name="Powder Blue Tang",
            calories_provided=3600,
            calories_needed=4350,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Stalked Kelp",
                "Purple Hydrocoral"
                ]),
    Species(name="Porcupine Pufferfish",
            calories_provided=2600,
            calories_needed=3800,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Peacock's Tail Algae",
                "Passer Angelfish"
                ]),
    Species(name="Passer Angelfish",
            calories_provided=2250,
            calories_needed=4600,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Peacock's Tail Algae"
                ]),
    Species(name="Pacific Tripletail",
            calories_provided=2150,
            calories_needed=2900,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Coral Beauty"
                ]),
    Species(name="Olive Ridley Turtle",
            calories_provided=3550,
            calories_needed=4400,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Green Zoanthid",
                "Pacific Tripletail"
                ]),
    Species(name="Northern Red Snapper",
            calories_provided=1200,
            calories_needed=2150,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Majestic Angelfish",
                "Sailfin Tang",
                "Flame Angelfish",
                "Eyestripe Surgeonfish"
                ]),
    Species(name="Majestic Angelfish",
            calories_provided=1150,
            calories_needed=3200,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Sailfin Tang",
                "Powder Blue Tang",
                "Eyestripe Surgeonfish",
                "Stalked Kelp"
                ]),
    Species(name="Long Finned Pilot Whale",
            calories_provided=3100,
            calories_needed=950,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Pacific Tripletail"
                ]),
    Species(name="Indo-Pacific Sailfish",
            calories_provided=1600,
            calories_needed=5600,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Pacific Tripletail",
                "Coral Beauty",
                "Flameback Angelfish"
                ]),
    Species(name="Hawksbill Sea Turtle",
            calories_provided=2800,
            calories_needed=4950,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Blue Striped Angelfish",
                "Queen Parrotfish",
                "Foxface Rabbitfish",
                "Common Eel Grass",
                "Fire Coral"
                ]),
    Species(name="Gem Tang",
            calories_provided=1250,
            calories_needed=4900,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=["Widgeon Grass"]),
    Species(name="Foxface Rabbitfish",
            calories_provided=800,
            calories_needed=4050,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=[
                "Widgeon Grass",
                "Fire Coral"
                ]),
    Species(name="Flameback Angelfish",
            calories_provided=2900,
            calories_needed=4750,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Green Zoanthid"
                ]),
    Species(name="Flame Angelfish",
            calories_provided=2200,
            calories_needed=4000,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Stalked Kelp",
                "Rock Weed"
                ]),
    Species(name="Eyestripe Surgeonfish",
            calories_provided=1050,
            calories_needed=3900,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Stalked Kelp",
                "Rock Weed"
                ]),
    Species(name="Cuvier Beaked Whale",
            calories_provided=1400,
            calories_needed=2250,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Coral Beauty",
                "Flameback Angelfish"
                ]),
    Species(name="Coral Trout",
            calories_provided=1850,
            calories_needed=3000,
            depth_range="61-90m",
            temperature_range="25-26.6",
            food_sources=[
                "Bicolour Angelfish",
                "Powder Blue Tang",
                "Flame Angelfish"
                ]),
    Species(name="Coral Beauty",
            calories_provided=2650,
            calories_needed=4900,
            depth_range="31-60m",
            temperature_range="26.7-28.2",
            food_sources=[
                "Yellow Tube Sponge",
                "Peacock's Tail Algae"
                ]),
    Species(name="Common Dolphinfish",
            calories_provided=2150,
            calories_needed=2100,
            depth_range="0-30m",
            temperature_range="28.3-30",
            food_sources=["Queen Parrotfish"])
]

Find the species that form a sustainable food chain

from mckinseysolvegame import Solver

Solver().find_sustainable_food_chain(my_species)

The API will return a JSON object with the following format:

{
        "Fire Coral": {
                "calories_needed": 0,
                "calories_provided": 1150
        },
        "Widgeon Grass": {
                "calories_needed": 0,
                "calories_provided": 50
        },
        "Common Eel Grass": {
                "calories_needed": 0,
                "calories_provided": 400
        },
        "Queen Parrotfish": {
                "calories_needed": 0,
                "calories_provided": 700,
                "eats": ["Fire Coral"]
        },
        "Blue Striped Angelfish": {
                "calories_needed": 0,
                "calories_provided": 1250,
                "eats": ["Common Eel Grass"]
        },
        "Queen Angelfish": {
                "calories_needed": 0,
                "calories_provided": 2600,
                "eats": ["Queen Parrotfish"]
        },
        "Wahoo": {
                "calories_needed": 0,
                "calories_provided": 1700,
                "eats": ["Blue Striped Angelfish"]
        },
        "Gem Tang": {
                "calories_needed": 0,
                "calories_provided": 1250,
                "eats": ["Widgeon Grass"]
        }
}

This dictionary contains the species name in order of eating, the food eaten as well as their final calories provided and needed.

Contributing

We welcome contributions to mckinseysolvegame! If you find a bug or would like to request a new feature, please open an issue on the Github repository. If you would like to contribute code, please submit a pull request.

License

mckinseysolvegame is released under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mckinseysolvegame-1.0.7.tar.gz (12.8 kB view details)

Uploaded Source

Built Distribution

mckinseysolvegame-1.0.7-py3-none-any.whl (12.0 kB view details)

Uploaded Python 3

File details

Details for the file mckinseysolvegame-1.0.7.tar.gz.

File metadata

  • Download URL: mckinseysolvegame-1.0.7.tar.gz
  • Upload date:
  • Size: 12.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for mckinseysolvegame-1.0.7.tar.gz
Algorithm Hash digest
SHA256 4f0302b1af3f1e32d6e06d3e1eb4e57fb673c88a47d0e7993e02901483c5e78e
MD5 8fa0f37834ba6462b9f008b42b967817
BLAKE2b-256 be4ae9f48a69ededa70022fc9f6ea60bd80f5770a2c0fc36b9a1f596b481f898

See more details on using hashes here.

File details

Details for the file mckinseysolvegame-1.0.7-py3-none-any.whl.

File metadata

File hashes

Hashes for mckinseysolvegame-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 4a3a7a1030a43d1f2e09da73b6654c92b6446cc0d12fb75ad89c728de961f9ed
MD5 2729e175202f6fdd5325a1e888772d33
BLAKE2b-256 b3d8f16bf9de06b5af0a41fc6363624d2998f12f4b6e5e4533531d0d04a779ea

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page