> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Liquid Cooling Market Watch

> Automated Analysis of Liquid Cooling Technology Providers and Adopters

## Why It Matters

The rapid growth of AI and high-performance computing is driving unprecedented energy demands in data centers, making efficient cooling solutions critical for operational sustainability and cost management. Traditional air cooling is reaching its limits, creating opportunities for liquid cooling technology providers and early adoption advantages for data center operators, but tracking these developments across fragmented industry coverage is challenging for investment decisions.

## What It Does

Using the functions available in the `bigdata-research-tools` package, you can create a comprehensive liquid cooling ecosystem analysis tool that identifies technology providers, tracks customer adoption patterns, and maps provider-customer relationships using unstructured data from news sources. These functions are suitable for technology analysts, infrastructure investors, and industry professionals to create tools that transform scattered technology signals into quantified market intelligence and identify investment opportunities in the cooling technology value chain.

## How It Works

This workflow combines **dual-role classification** and **temporal tracking** to deliver:

* **Provider vs. adopter identification** distinguishing companies developing liquid cooling solutions from those implementing them
* **Technology ecosystem mapping** revealing relationships between solution providers and data center operators
* **Adoption timeline tracking** showing how liquid cooling implementation evolves across different sectors
* **Market positioning analysis** quantifying each company's role and exposure in the liquid cooling ecosystem

## A Real-World Use Case

This cookbook demonstrates the complete workflow through analyzing liquid cooling technology dynamics across the data center industry using news data, showing how the system automatically identifies technology leaders, tracks customer adoption patterns, and reveals provider-customer networks through automated relationship analysis.

**Ready to get started? Let's dive in!**

<a href="https://github.com/Bigdata-com/bigdata-cookbook/tree/main/Liquid_Cooling_Market_Watch" target="_blank">
  <img alt="Open in GitHub" noZoom src="https://img.shields.io/badge/GitHub-View%20Repository-black?style=flat&logo=github" />
</a>

## Prerequisites

To run the Liquid Cooling Market Watch workflow, you can choose between two options:

* 💻 **GitHub cookbook**
  * Use this if you prefer working locally or in a custom environment.
  * Follow the setup and execution instructions in the [`README.md`](https://github.com/Bigdata-com/bigdata-cookbook/blob/main/Liquid_Cooling_Market_Watch/README.md).
  * API keys are required:
    * Option 1: Follow the key setup process described in the [`README.md`](https://github.com/Bigdata-com/bigdata-cookbook/blob/main/Liquid_Cooling_Market_Watch/README.md)
    * Option 2: Refer to this guide: [How to initialise environment variables](https://docs.bigdata.com/how-to-guides/how_to_prerequisites#initialise-environment-variables)
      * ❗ When using this method, you must manually add the OpenAI API key:
        ```python theme={null}
        # OpenAI credentials
        OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"
        ```

* 🐳 **Docker Installation**
  * [Docker installation](https://github.com/Bigdata-com/bigdata-cookbook/blob/main/Liquid_Cooling_Market_Watch/README.md#docker-installation-and-usage) is available for containerized deployment.
  * Provides an alternative setup method with containerized deployment, simplifying the environment configuration for those preferring Docker-based solutions.

## Setup and Imports

Below is the Python code required for setting up our environment and importing necessary libraries.

```python [expandable] theme={null}
import pandas as pd

from src.tool import plot_top_companies_by_sector, transform_to_reference_format, identify_basket_and_plot_confidence, analyze_basket_with_labels
from src.search import search_cooling
from src.labeling import run_liquid_cooling_prompt
from src.network_analysis import provider_adopter_net

from bigdata_client import Bigdata
from bigdata_client.models.search import DocumentType
from bigdata_research_tools.excel import ExcelManager

# Setup for Plotly in Colab
import plotly.io as pio
import plotly.graph_objects as go
import plotly.offline as pyo

pyo.init_notebook_mode(connected=True)
pio.renderers.default = 'colab'
print("✅ Plotly configured for Colab")

# Define output file paths for our results
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

export_path = f"{output_dir}/liquid_cooling_analysis_results.xlsx"
```

## Defining your Liquid Cooling Analysis Parameters

### Fixed Parameters

* **Provider Theme** (`provider_theme`): The central concept to explore for liquid cooling technology providers
* **Adopter Theme** (`adopter_theme`): The concept to explore for companies adopting liquid cooling in their data centers
* **Provider Sentences** (`provider_sentences_list`): Sentences used to identify companies providing liquid cooling solutions
* **Adopter Sentences** (`adopter_sentences_list`): Sentences used to identify companies adopting liquid cooling technology
* **Document Type** (`document_type`): Specify which documents to search over (transcripts, filings, news)

```python theme={null}
# ===== Fixed Parameters =====

# Liquid Cooling Provider Theme
provider_theme = "The target company only is a provider of liquid cooling technology for data centers, not an adopter"

# Liquid Cooling Adopter Theme
adopter_theme = "The target company is an adopter of liquid cooling technology for data centers, not a provider"

# Sentences expressing liquid cooling provider narratives
provider_sentences_list = [
    'Company develops liquid cooling systems for data centers',
    'Firm manufactures liquid cooling solutions for servers',
    'Organization provides immersion cooling technology',
    'Corporation supplies water cooling systems for data centers',
    'Company offers liquid cooling infrastructure solutions',
    'Business develops advanced liquid cooling technology',
    'Enterprise manufactures server liquid cooling systems',
    'Firm provides data center cooling solutions',
    'Company creates liquid cooling products for servers',
    'Organization designs immersion cooling systems',
    'Corporation develops water cooling technology',
    'Business supplies liquid cooling equipment',
    'Enterprise offers advanced cooling solutions for data centers',
    'Company produces liquid cooling infrastructure',
    'Firm develops innovative cooling technology',
    'Organization manufactures liquid cooling hardware',
    'Corporation provides cooling system integration',
    'Business creates data center cooling products',
    'Enterprise develops liquid cooling platforms',
    'Company supplies advanced cooling systems',
    'Firm offers liquid cooling consulting services',
    'Organization provides cooling technology solutions',
    'Corporation develops liquid cooling innovations',
    'Business manufactures cooling system components',
    'Enterprise offers liquid cooling design services'
]

# Sentences expressing liquid cooling adoption narratives
adopter_sentences_list = [
    'Company adopts liquid cooling in data centers',
    'Firm implements liquid cooling technology',
    'Organization installs immersion cooling systems',
    'Corporation deploys water cooling in data centers',
    'Company uses liquid cooling for servers',
    'Business adopts advanced cooling technology',
    'Enterprise implements liquid cooling infrastructure',
    'Firm installs liquid cooling systems',
    'Company deploys immersion cooling technology',
    'Organization uses water cooling systems',
    'Corporation adopts liquid cooling solutions',
    'Business implements advanced cooling systems',
    'Enterprise deploys liquid cooling in facilities',
    'Company installs advanced cooling technology',
    'Firm uses liquid cooling infrastructure',
    'Organization implements cooling system upgrades',
    'Corporation adopts immersion cooling systems',
    'Business deploys liquid cooling solutions',
    'Enterprise uses advanced cooling technology',
    'Company implements liquid cooling in operations',
    'Firm adopts cooling system innovations',
    'Organization deploys advanced cooling infrastructure',
    'Corporation uses liquid cooling for efficiency',
    'Business implements cooling technology upgrades',
    'Enterprise adopts liquid cooling systems'
]

# Document Configuration
document_type = DocumentType.NEWS
```

### Customizable Parameters

* **Watchlist** (`my_watchlist_id`): The set of companies to analyze. This is the ID of your watchlist on the [watchlist section](https://app.bigdata.com/watchlists) of the app. If set to `None`, each company referenced in the retrieved chunks will be analyzed.
* **Model Selection** (`llm_model`): The LLM model used to label search result document chunks and generate summaries
* **Frequency** (`freq`): The frequency of the date ranges to search over.
  Supported values:
  * `Y`: Yearly intervals.
  * `M`: Monthly intervals.
  * `W`: Weekly intervals.
  * `D`: Daily intervals. Defaults to `M`.
* **Time Period** (`start_date` and `end_date`): The date range over which to run the analysis
* **Document Sources** (`sources`): Specify set of sources within a document type, for example which news outlets (available via Bigdata API) you wish to search over
* **Rerank Threshold** (`rerank_threshold`): By setting this value, you're enabling the cross-encoder which reranks the results and selects those whose relevance is above the percentile you specify (0.7 being the 70th percentile). More information on the re-ranker can be found [here](https://sdk.bigdata.com/en/latest/how_to_guides/rerank_search.html).
* **Document Limit** (`document_limit`): The maximum number of documents to return per query to Bigdata API
* **Batch Size** (`batch_size`): The number of entities to include in a single batched query

```python theme={null}
# ===== Customizable Parameters =====

# Company Universe (from Watchlist)
my_watchlist_id = None  # Replace with your watchlist ID
if my_watchlist_id is not None:
    watchlist = bigdata.watchlists.get(my_watchlist_id)
    companies = bigdata.knowledge_graph.get_entities(watchlist.items)
else:
    companies = None

# LLM Specification
llm_model = "openai::gpt-4o-mini"

# Search Frequency
search_frequency = 'M'

# Enable/Disable Reranker
rerank_threshold = None

# Specify Time Range
start_date = "2021-01-01"
end_date = "2024-06-30"

# Document Limits
document_limit = 15

# Others
batch_size = 10
```

## Retrieve Content using Bigdata's Search Capabilities

With the liquid cooling narratives and analysis parameters, you can leverage the Bigdata API to run a search on company news for both provider and adopter indicators.

```python theme={null}
df_sentences_provider = search_cooling(
    sentences=provider_sentences_list,
    start_date=start_date,
    end_date=end_date,
    scope=document_type,
    rerank_threshold=rerank_threshold,
    freq=search_frequency,
    document_limit=document_limit,
    batch_size=batch_size,
    keywords=["liquid cooling","data center"]
)

df_sentences_adopter = search_cooling(
    sentences=adopter_sentences_list,
    start_date=start_date,
    end_date=end_date,
    scope=document_type,
    rerank_threshold=rerank_threshold,
    freq=search_frequency,
    document_limit=document_limit,
    batch_size=batch_size,
    keywords=["liquid cooling","data center"]
)

# Combine and process all data
df_all = pd.concat([df_sentences_provider, df_sentences_adopter], ignore_index=True)
df_all = df_all.drop_duplicates(subset=['document_id', 'sentence_id', 'headline', 'entity_id', 'entity_name', 'text'])
```

## Label the Results

Use an LLM to analyze each document chunk and determine its relevance to liquid cooling technology, classifying companies as either providers (P), adopters (A), or unrelated (U).

```python theme={null}
df_all = df_all.rename(columns={
    'entity_id': 'rp_entity_id',
    'document_id': 'rp_document_id',
})

df_all_labeled = run_liquid_cooling_prompt(
    sentences=df_all,
    masked_2=True,
    batch_size=10,
    open_ai_credentials=OPENAI_API_KEY
)

# Transform and separate by role
df_all_labeled_transform = transform_to_reference_format(df_all_labeled)
df_providers = df_all_labeled_transform[df_all_labeled_transform["label"] == "P"].copy()
df_providers.reset_index(drop=True, inplace=True)
df_adopters = df_all_labeled_transform[df_all_labeled_transform["label"] == "A"].copy()
df_adopters.reset_index(drop=True, inplace=True)
```

## Visualizations

### Sector-Based Liquid Cooling Technology Visualization

The following visualizations provide a sector-by-sector breakdown of companies involved in liquid cooling technology. These charts help identify:

* **Industry Patterns**: Which sectors show more liquid cooling activity
* **Technology Leaders**: Companies most frequently mentioned in liquid cooling contexts within each sector
* **Story Context**: Detailed hover information reveals the specific headlines, motivations, and news excerpts driving each company's positioning

Each bar represents the frequency of liquid cooling mentions, with hover details providing the underlying news narrative that shaped each company's role in the liquid cooling ecosystem.

#### Companies Providing Liquid Cooling Solutions

This chart displays companies that have been most frequently mentioned as providers of liquid cooling technology, organized by sector and ranked by total mention volume. The visualization reveals which companies and industries are leading the development and supply of liquid cooling solutions for data centers.

```python theme={null}
plot_top_companies_by_sector(df_providers, min_companies=1, title_suffix="(Liquid Cooling Providers)", top_sectors=4)
```

<video
  autoPlay
  muted
  loop
  onClick={(e) => {
const video = e.currentTarget;
if (video.requestFullscreen) {
  video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
  video.webkitRequestFullscreen(); // Safari
} else if (video.msRequestFullscreen) {
  video.msRequestFullscreen(); // IE11
}
}}
  className="w-full rounded-xl cursor-pointer"
  src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/top_providers.mp4?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=4c52b5f9c523392c5c7e0df8e63a5b09"
  data-path="images/liquid-cooling/top_providers.mp4"
/>

#### Companies Adopting Liquid Cooling Technology

This complementary chart shows companies most frequently mentioned as adopters of liquid cooling technology in their data centers, organized by sector and ranked by total mention volume. It identifies firms investing in liquid cooling infrastructure and implementing new cooling systems.

```python theme={null}
plot_top_companies_by_sector(df_adopters, min_companies=1, title_suffix="(Liquid Cooling Adopters)", top_sectors=4)
```

<video
  autoPlay
  muted
  loop
  onClick={(e) => {
const video = e.currentTarget;
if (video.requestFullscreen) {
  video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
  video.webkitRequestFullscreen(); // Safari
} else if (video.msRequestFullscreen) {
  video.msRequestFullscreen(); // IE11
}
}}
  className="w-full rounded-xl cursor-pointer"
  src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/top_adopters.mp4?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=41f7727523d14394a5d7ece2fb5de8d4"
  data-path="images/liquid-cooling/top_adopters.mp4"
/>

## Liquid Cooling Ecosystem Analysis

This comprehensive assessment combines both provider and adopter signals to create a complete picture of the liquid cooling ecosystem. The analysis provides:

* **Total Exposure**: Overall volume of liquid cooling related news coverage for each company
* **Role Classification**: Relative proportion of provider versus adopter mentions
* **Market Positioning**: How companies rank in terms of their involvement in the liquid cooling market

The stacked bar chart shows the percentage breakdown of provider (green) versus adopter (red) mentions for the top companies. Companies with predominantly green bars are primarily technology providers, while those with red bars are mainly end-users implementing liquid cooling solutions.

```python theme={null}
companies_basket = identify_basket_and_plot_confidence(
    df_providers, 
    df_adopters, 
    basket_size=40, 
    theme_name='Liquid Cooling', 
    positive_label='Providers', 
    negative_label='Adopters'
)
```

<video
  autoPlay
  muted
  loop
  onClick={(e) => {
const video = e.currentTarget;
if (video.requestFullscreen) {
  video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
  video.webkitRequestFullscreen(); // Safari
} else if (video.msRequestFullscreen) {
  video.msRequestFullscreen(); // IE11
}
}}
  className="w-full rounded-xl cursor-pointer"
  src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/barometer.mp4?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=2a513e1901eb800ca8dda9fe37bd4b2a"
  data-path="images/liquid-cooling/barometer.mp4"
/>

## Temporal Liquid Cooling Analysis

This time-series analysis tracks how liquid cooling narratives evolve over time for companies in our ecosystem. The monthly analysis reveals:

* **Technology Trends**: How liquid cooling adoption and development stories develop over time
* **Market Evolution**: The balance between provider and adopter activities across different periods

Each line represents a company's "net liquid cooling exposure" (provider mentions minus adopter mentions). Points above zero indicate weeks with net provider activity, while points below zero show weeks with net adopter activity.

```python theme={null}
monthly_exposure = analyze_basket_with_labels(
    df_providers, 
    df_adopters, 
    companies_basket, 
    start_date, 
    end_date, 
    'Sector',
    theme_name='Liquid Cooling',
    interactive=True,
    frequency='monthly',
    analysis_suffix = "Monthly Analysis"
)
```

<video
  autoPlay
  muted
  loop
  onClick={(e) => {
const video = e.currentTarget;
if (video.requestFullscreen) {
  video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
  video.webkitRequestFullscreen(); // Safari
} else if (video.msRequestFullscreen) {
  video.msRequestFullscreen(); // IE11
}
}}
  className="w-full rounded-xl cursor-pointer"
  src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/monthly_trend.mp4?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=211777a06107e23f6a815b8596d3c99e"
  data-path="images/liquid-cooling/monthly_trend.mp4"
/>

<Frame>
  <img src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/industrial_liquid.png?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=0e169e2cdbe596d532785f738e6a4539" alt="Monthly Analysis - Industrial" width="1178" height="500" data-path="images/liquid-cooling/industrial_liquid.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/energy_liquid.png?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=8e231551ca0d6fbae86220b0a3e30d7b" alt="Monthly Analysis - Energy" width="1178" height="500" data-path="images/liquid-cooling/energy_liquid.png" />
</Frame>

## Provider-Adopter Network Analysis

This network visualization reveals relationships between liquid cooling technology providers and adopters through co-mentions in news articles. The analysis identifies:

* **Technology Partnerships**: Companies that frequently appear together in liquid cooling contexts
* **Customer-Supplier Relationships**: Connections between solution providers and data center operators
* **Market Clusters**: Groups of companies operating in similar segments of the liquid cooling ecosystem

```python theme={null}
fig = provider_adopter_net(
    df_filtered_adopters=df_adopters,
    df_filtered_providers=df_providers,
    bigdata_cred=None,
    min_occurrences=5,  # Adjust to see more or fewer companies
    dash=False,
    interactive=True
)
```

<video
  autoPlay
  muted
  loop
  onClick={(e) => {
const video = e.currentTarget;
if (video.requestFullscreen) {
  video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
  video.webkitRequestFullscreen(); // Safari
} else if (video.msRequestFullscreen) {
  video.msRequestFullscreen(); // IE11
}
}}
  className="w-full rounded-xl cursor-pointer"
  src="https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/images/liquid-cooling/network.mp4?fit=max&auto=format&n=oXZ2k4-F2a4nJaoe&q=85&s=5594e927c768569cd8b77f17a357c90d"
  data-path="images/liquid-cooling/network.mp4"
/>

## Key Insights and Technology Stories

The liquid cooling analysis reveals several important technology adoption patterns:

<Card title="Technology Provider Leadership">
  Companies like Dell, NVIDIA, and specialized cooling system manufacturers are leading the development of liquid cooling solutions, with frequent mentions of new product launches and technology partnerships.
</Card>

<Card title="Data Center Operator Adoption">
  Major cloud providers and data center operators are increasingly implementing liquid cooling systems to improve energy efficiency and support high-density computing workloads, particularly for AI and machine learning applications.
</Card>

<Card title="Supply Chain Relationships">
  The network analysis reveals emerging partnerships between cooling technology providers and data center operators, indicating the development of integrated solutions and long-term supply relationships.
</Card>

<Card title="Market Evolution">
  The temporal analysis shows increasing adoption momentum, with more frequent mentions of liquid cooling implementations as organizations seek to address growing energy and performance demands in modern data centers.
</Card>

## Export the Results

Export the data as Excel files for further analysis or to share with the team.

```python theme={null}
try:
    # Create the Excel manager
    excel_manager = ExcelManager()

    # Define the dataframes and their sheet configurations
    df_args = [
        (df_providers, "Liquid Cooling Providers", (0, 0)),
        (df_adopters, "Liquid Cooling Adopters", (0, 0)),
        (companies_basket, "Technology Ecosystem Basket", (2, 4)),
        (monthly_exposure, "Monthly Exposure Analysis", (2, 2))
    ]

    # Save the workbook
    excel_manager.save_workbook(df_args, export_path)
    print(f"✅ Results exported to {export_path}")

except Exception as e:
    print(f"Warning while exporting to excel: {e}")
```

## Conclusion

The Liquid Cooling Market Watch analysis provides a comprehensive automated framework for analyzing the liquid cooling ecosystem across the data center industry. By systematically combining advanced information retrieval with LLM-powered classification, this workflow transforms unstructured news data into actionable intelligence for strategic decision-making.

Through the automated analysis of liquid cooling technology dynamics, you can:

1. **Identify technology leaders** - Discover companies developing cutting-edge liquid cooling solutions and those implementing these technologies in their operations

2. **Map ecosystem relationships** - Reveal partnerships and customer-supplier relationships between solution providers and data center operators through network analysis

3. **Track adoption patterns** - Monitor how liquid cooling implementation evolves across different sectors and time periods, identifying emerging trends and market momentum

4. **Analyze competitive positioning** - Compare companies' roles in the liquid cooling ecosystem, distinguishing between technology developers and end-users

5. **Monitor technology evolution** - Track how liquid cooling narratives develop over time, identifying shifts in market leadership and adoption patterns

From conducting technology due diligence to building investment strategies focused on data center infrastructure or identifying opportunities in the cooling technology supply chain, the Liquid Cooling Market Watch analysis automates the research process while maintaining the depth required for professional technology analysis. The dual-classification methodology ensures clear distinction between solution providers and adopters, making it an invaluable tool for systematic market assessment in the rapidly evolving data center cooling technology landscape.
