mage-ai 0.9.69__py3-none-any.whl → 0.9.71__py3-none-any.whl

mage_ai/data_preparation/models/block/outputs.py

@@ -0,0 +1,722 @@
+import json
+import os
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+import pandas as pd
+import polars as pl
+import simplejson
+from sklearn.utils import estimator_html_repr
+
+from mage_ai.ai.utils.xgboost import render_tree_visualization
+from mage_ai.data.constants import InputDataType
+from mage_ai.data.models.constants import CHUNKS_DIRECTORY_NAME
+from mage_ai.data.tabular.models import BatchSettings
+from mage_ai.data.tabular.reader import read_metadata
+from mage_ai.data.tabular.utils import (
+    convert_series_list_to_dataframe,
+    series_to_dataframe,
+)
+from mage_ai.data_cleaner.shared.utils import is_geo_dataframe, is_spark_dataframe
+from mage_ai.data_preparation.models.block.dynamic.utils import (
+    is_dynamic_block,
+    is_dynamic_block_child,
+)
+from mage_ai.data_preparation.models.block.settings.variables.models import (
+    ChunkKeyTypeUnion,
+)
+from mage_ai.data_preparation.models.constants import (
+    DATAFRAME_ANALYSIS_MAX_COLUMNS,
+    DATAFRAME_SAMPLE_COUNT,
+    DATAFRAME_SAMPLE_COUNT_PREVIEW,
+)
+from mage_ai.data_preparation.models.utils import (
+    infer_variable_type,
+    is_basic_iterable,
+    is_primitive,
+)
+from mage_ai.data_preparation.models.variables.constants import VariableType
+from mage_ai.server.kernel_output_parser import DataType
+from mage_ai.settings.server import MEMORY_MANAGER_V2
+from mage_ai.shared.hash import merge_dict
+from mage_ai.shared.parsers import (
+    convert_matrix_to_dataframe,
+    encode_complex,
+    has_to_dict,
+)
+from mage_ai.shared.strings import is_json
+
+
+def format_output_data(
+    block,
+    data: Any,
+    variable_uuid: str,
+    block_uuid: Optional[str] = None,
+    csv_lines_only: Optional[bool] = False,
+    execution_partition: Optional[str] = None,
+    index: Optional[int] = None,
+    skip_dynamic_block: bool = False,
+    automatic_sampling: bool = False,
+    sample_count: Optional[int] = None,
+) -> Tuple[Dict, bool]:
+    """
+    Takes variable data and formats it to return to the frontend.
+
+    Returns:
+        Tuple[Dict, bool]: Tuple of the formatted data and is_data_product boolean. Data product
+            outputs and non data product outputs are handled slightly differently.
+    """
+    if not block_uuid:
+        block_uuid = block.uuid
+
+    variable_type, basic_iterable = infer_variable_type(data)
+
+    variable_manager = block.pipeline.variable_manager
+
+    is_dynamic_child = is_dynamic_block_child(block)
+    is_dynamic = is_dynamic_block(block)
+
+    if (
+        variable_type in [VariableType.DATAFRAME, VariableType.POLARS_DATAFRAME]
+        and is_basic_iterable
+        and isinstance(data, list)
+        and not is_dynamic
+    ):
+        formatted_outputs = []
+        for output_idx, output in enumerate(data):
+            output_formatted, _ = format_output_data(
+                block,
+                output,
+                os.path.join(variable_uuid, str(output_idx)),
+                automatic_sampling=automatic_sampling,
+                block_uuid=block_uuid,
+                csv_lines_only=csv_lines_only,
+                execution_partition=execution_partition,
+                index=index,
+                sample_count=sample_count,
+                skip_dynamic_block=skip_dynamic_block,
+            )
+            formatted_outputs.append(output_formatted)
+
+        return dict(
+            outputs=formatted_outputs,
+            type=DataType.GROUP,
+            variable_uuid=variable_uuid,
+        ), True
+    elif VariableType.SERIES_PANDAS == variable_type:
+        if automatic_sampling and not sample_count:
+            sample_count = min(len(data), DATAFRAME_SAMPLE_COUNT)
+        if basic_iterable:
+            data = pd.DataFrame(data).T
+        else:
+            data = data.to_frame()
+    elif VariableType.SERIES_POLARS == variable_type:
+        if automatic_sampling and not sample_count:
+            sample_count = min(len(data), DATAFRAME_SAMPLE_COUNT)
+        if basic_iterable:
+            data = convert_series_list_to_dataframe(data)
+        else:
+            data = series_to_dataframe(data)
+    elif VariableType.ITERABLE == variable_type and isinstance(data, list):
+        data = pd.Series(data).to_frame()
+
+    if VariableType.MATRIX_SPARSE == variable_type:
+        if automatic_sampling and not sample_count:
+            n_rows, n_cols = data.shape
+            max_dims = min(
+                DATAFRAME_ANALYSIS_MAX_COLUMNS * DATAFRAME_SAMPLE_COUNT, n_rows * n_cols
+            )
+            sample_count = round(max_dims / n_cols)
+        if basic_iterable:
+            data = convert_matrix_to_dataframe(data[0])
+        else:
+            data = convert_matrix_to_dataframe(data)
+
+        return format_output_data(
+            block,
+            data,
+            variable_uuid=variable_uuid,
+            block_uuid=block_uuid,
+            csv_lines_only=csv_lines_only,
+            execution_partition=execution_partition,
+            skip_dynamic_block=skip_dynamic_block,
+            automatic_sampling=automatic_sampling,
+            index=index,
+            sample_count=sample_count,
+        )
+    elif VariableType.CUSTOM_OBJECT == variable_type:
+        return_output = dict(
+            text_data=encode_complex(data),
+            variable_uuid=variable_uuid,
+        )
+        if has_to_dict(data):
+            return_output['type'] = DataType.OBJECT
+        else:
+            return_output['type'] = DataType.TEXT
+
+        return return_output, True
+    elif (
+        VariableType.MODEL_SKLEARN == variable_type or VariableType.MODEL_XGBOOST == variable_type
+    ):
+
+        def __render(
+            model: Any,
+            partition=execution_partition,
+            pipeline=block.pipeline,
+            uuid=block.uuid,
+            variable_manager=variable_manager,
+            variable_type=variable_type,
+            variable_uuid=variable_uuid,
+        ) -> Dict[str, Optional[str]]:
+            data_type = None
+            text_data = None
+
+            if VariableType.MODEL_SKLEARN == variable_type:
+                data_type = DataType.TEXT_HTML
+                text_data = estimator_html_repr(model)
+            elif variable_manager:
+                image_dir = variable_manager.build_variable(
+                    pipeline_uuid=pipeline.uuid if pipeline.uuid else None,
+                    block_uuid=uuid,
+                    variable_uuid=variable_uuid,
+                    partition=partition,
+                    variable_type=variable_type,
+                ).variable_path
+                text_data, success = render_tree_visualization(image_dir)
+
+                if success:
+                    data_type = DataType.IMAGE_PNG
+                else:
+                    data_type = DataType.TEXT
+
+            return dict(
+                text_data=text_data,
+                type=data_type,
+                variable_uuid=variable_uuid,
+            )
+
+        if not basic_iterable:
+            return __render(data), True
+
+        data = dict(
+            text_data=simplejson.dumps(
+                [__render(d) for d in data],
+                default=encode_complex,
+                ignore_nan=True,
+            ),
+            type=DataType.TEXT,
+            variable_uuid=variable_uuid,
+        )
+
+        return data, True
+    elif (is_dynamic_child or is_dynamic) and not skip_dynamic_block:
+        from mage_ai.data_preparation.models.block.dynamic.utils import (
+            coerce_into_dataframe,
+        )
+
+        if VariableType.LIST_COMPLEX == variable_type and basic_iterable and len(data) >= 1:
+            data = [encode_complex(item) for item in data]
+
+        return format_output_data(
+            block,
+            data=coerce_into_dataframe(
+                data,
+                is_dynamic=is_dynamic,
+                is_dynamic_child=is_dynamic_child,
+            ),
+            automatic_sampling=automatic_sampling,
+            execution_partition=execution_partition,
+            index=index,
+            sample_count=sample_count,
+            skip_dynamic_block=True,
+            variable_uuid=variable_uuid,
+        )
+    elif isinstance(data, pd.DataFrame):
+        if csv_lines_only:
+            data = dict(table=data.to_csv(header=True, index=False).strip('\n').split('\n'))
+        else:
+            try:
+                analysis = block.get_analysis(
+                    block_uuid=block_uuid,
+                    index=index,
+                    partition=execution_partition,
+                    variable_uuid=variable_uuid,
+                )
+            except Exception as err:
+                print(f'Error getting dataframe analysis for block {block_uuid}: {err}')
+                analysis = None
+
+            if analysis is not None and (analysis.get('statistics') or analysis.get('metadata')):
+                stats = analysis.get('statistics', {})
+                column_types = (analysis.get('metadata') or {}).get('column_types', {})
+                row_count = stats.get('original_row_count', stats.get('count'))
+                column_count = stats.get('original_column_count', len(column_types))
+            else:
+                row_count, column_count = data.shape
+
+            columns_to_display = data.columns.tolist()[:DATAFRAME_ANALYSIS_MAX_COLUMNS]
+
+            if automatic_sampling and not sample_count:
+                data = data.iloc[:DATAFRAME_SAMPLE_COUNT]
+            elif sample_count:
+                data = data.iloc[:sample_count]
+
+            data = dict(
+                sample_data=dict(
+                    columns=columns_to_display,
+                    rows=json.loads(
+                        data[columns_to_display].to_json(orient='split', date_format='iso'),
+                    )['data'],
+                ),
+                shape=[row_count, column_count],
+                type=DataType.TABLE,
+                variable_uuid=variable_uuid,
+            )
+
+            if MEMORY_MANAGER_V2:
+                data['resource_usage'] = block.get_resource_usage(
+                    block_uuid=block_uuid,
+                    partition=execution_partition,
+                    variable_uuid=variable_uuid,
+                    index=index,
+                )
+
+        return data, True
+    elif isinstance(data, pl.DataFrame):
+        try:
+            analysis = block.get_analysis(
+                block_uuid=block_uuid,
+                index=index,
+                partition=execution_partition,
+                variable_uuid=variable_uuid,
+            )
+        except Exception as err:
+            raise err
+            analysis = None
+        if analysis is not None:
+            stats = analysis.get('statistics', {})
+            row_count = stats.get('original_row_count')
+            column_count = stats.get('original_column_count')
+        else:
+            row_count, column_count = data.shape
+
+        columns_to_display = data.columns[:DATAFRAME_ANALYSIS_MAX_COLUMNS]
+        sample_count = sample_count or DATAFRAME_SAMPLE_COUNT_PREVIEW
+        resource_usage = None
+
+        if MEMORY_MANAGER_V2:
+            variable = block.get_variable_object(
+                block_uuid=block_uuid,
+                variable_uuid=variable_uuid,
+                partition=execution_partition,
+            )
+
+            metadata = read_metadata(
+                os.path.join(
+                    variable.variable_dir_path,
+                    variable_uuid,
+                    str(index) if index is not None else '',
+                    CHUNKS_DIRECTORY_NAME,
+                ),
+                include_schema=True,
+            )
+            if metadata:
+                try:
+                    row_count = metadata.get('num_rows') or row_count
+                    schema = metadata.get('schema')
+                    if schema and isinstance(schema, dict):
+                        column_count = len(schema) or column_count
+                except ValueError:
+                    pass
+
+            if sample_count is not None:
+                data = data[:sample_count]
+
+            resource_usage = block.get_resource_usage(
+                block_uuid=block_uuid,
+                partition=execution_partition,
+                variable_uuid=variable_uuid,
+                index=index,
+            )
+
+        data = dict(
+            sample_data=dict(
+                columns=columns_to_display,
+                rows=[
+                    list(row.values())
+                    for row in json.loads(data[columns_to_display].write_json(row_oriented=True))
+                ],
+            ),
+            resource_usage=resource_usage,
+            shape=[row_count, column_count],
+            type=DataType.TABLE,
+            variable_uuid=variable_uuid,
+        )
+        return data, True
+    elif is_geo_dataframe(data):
+        data = dict(
+            text_data=f"""Use the code in a scratchpad to get the output of the block:
+
+from mage_ai.data_preparation.variable_manager import get_variable
+df = get_variable('{block.pipeline.uuid}', '{block.uuid}', 'df')
+""",
+            type=DataType.TEXT,
+            variable_uuid=variable_uuid,
+        )
+        return data, False
+    elif is_primitive(data):
+        json_data = is_json(data)
+        if json_data:
+            text_data = json_data.get('data') or ''
+            if isinstance(text_data, list):
+                text_data = '\n'.join(text_data)
+            data = dict(
+                text_data=text_data,
+                type=DataType.TEXT_PLAIN,
+                variable_uuid=variable_uuid,
+            )
+        else:
+            data = dict(
+                text_data=str(data),
+                type=DataType.TEXT,
+                variable_uuid=variable_uuid,
+            )
+        return data, False
+    elif basic_iterable:
+        data = dict(
+            text_data=simplejson.dumps(
+                data,
+                default=encode_complex,
+                ignore_nan=True,
+            ),
+            type=DataType.TEXT,
+            variable_uuid=variable_uuid,
+        )
+        return data, False
+    elif isinstance(data, dict):
+        try:
+            pair = format_output_data(
+                block,
+                pd.DataFrame([data]),
+                variable_uuid=variable_uuid,
+                block_uuid=block_uuid,
+                csv_lines_only=csv_lines_only,
+                execution_partition=execution_partition,
+                skip_dynamic_block=skip_dynamic_block,
+                automatic_sampling=automatic_sampling,
+                sample_count=sample_count,
+            )
+            if len(pair) >= 1:
+                return pair[0], True
+        except Exception as err:
+            print(
+                f'[ERROR] Block.format_output_data for block '
+                f'{block.uuid} variable {variable_uuid}: {err}',
+            )
+
+        data = dict(
+            text_data=simplejson.dumps(
+                data,
+                default=encode_complex,
+                ignore_nan=True,
+            ),
+            type=DataType.TEXT,
+            variable_uuid=variable_uuid,
+        )
+        return data, False
+    elif is_spark_dataframe(data):
+        df = data.toPandas()
+        columns_to_display = df.columns.tolist()[:DATAFRAME_ANALYSIS_MAX_COLUMNS]
+        data = dict(
+            sample_data=dict(
+                columns=columns_to_display,
+                rows=json.loads(
+                    df[columns_to_display].to_json(orient='split', date_format='iso'),
+                )['data'],
+            ),
+            type=DataType.TABLE,
+            variable_uuid=variable_uuid,
+        )
+        return data, True
+
+    return data, False
+
+
+def get_outputs_for_display_dynamic_block(
+    block,
+    output_sets: List[Tuple],
+    child_data_sets: List[Tuple[Any, Any]],
+    block_uuid: Optional[str] = None,
+    csv_lines_only: bool = False,
+    dynamic_block_index: Optional[int] = None,
+    exclude_blank_variable_uuids: bool = False,
+    execution_partition: Optional[str] = None,
+    metadata: Optional[Dict] = None,
+    sample: bool = True,
+    sample_count: Optional[int] = None,
+) -> List[Dict[str, Any]]:
+    data_products = []
+    outputs = []
+    block_uuid = block_uuid if block_uuid else block.uuid
+
+    for idx, pairs in enumerate(child_data_sets):
+        child_data, metadata = pairs
+        formatted_outputs = []
+
+        if child_data is not None and isinstance(child_data, list) and len(child_data) >= 1:
+            for output_idx, output in enumerate(child_data):
+                output_formatted, _ = format_output_data(
+                    block,
+                    output,
+                    f'output_{output_idx}',
+                    block_uuid=block_uuid,
+                    csv_lines_only=csv_lines_only,
+                    execution_partition=execution_partition,
+                    index=output_idx,
+                    sample_count=sample_count // len(child_data)
+                    if sample_count is not None
+                    else None,
+                )
+                formatted_outputs.append(output_formatted)
+
+            # Override this with dynamic_block_index because execute_code_output from the IDE
+            # runs each dynamic child block asynchronously and prints the output immediately.
+            var_uuid = (
+                f'Dynamic child {dynamic_block_index if dynamic_block_index is not None else idx}'
+            )
+            data_products.append(
+                dict(
+                    outputs=formatted_outputs,
+                    type=DataType.GROUP,
+                    variable_uuid=var_uuid,
+                )
+            )
+        else:
+            output_sets.append((child_data, metadata))
+
+    for output_pair in output_sets:
+        child_data = None
+        metadata = None
+        if len(output_pair) >= 1:
+            child_data = output_pair[0]
+            if len(output_pair) >= 2:
+                metadata = output_pair[1]
+
+        for output, variable_uuid in [
+            (child_data, 'output_0'),
+            (metadata, 'output_1'),
+        ]:
+            if output is None or (exclude_blank_variable_uuids and variable_uuid.strip() == ''):
+                continue
+
+            variable_type, basic_iterable = infer_variable_type(output)
+            if (
+                variable_type in [VariableType.DATAFRAME, VariableType.POLARS_DATAFRAME]
+                and is_basic_iterable
+                and isinstance(output, list)
+            ):
+                for output_idx, output_data in enumerate(output):
+                    output_formatted, _ = format_output_data(
+                        block,
+                        output_data,
+                        variable_uuid,
+                        block_uuid=block_uuid,
+                        csv_lines_only=csv_lines_only,
+                        execution_partition=execution_partition,
+                        index=output_idx,
+                        sample_count=sample_count // len(output)
+                        if sample_count is not None
+                        else None,
+                    )
+                    data_products.append(
+                        dict(
+                            outputs=[output_formatted],
+                            type=DataType.GROUP,
+                            variable_uuid=os.path.join(variable_uuid, str(output_idx)),
+                        )
+                    )
+            else:
+                data, is_data_product = format_output_data(
+                    block,
+                    output,
+                    variable_uuid,
+                    block_uuid=block_uuid,
+                    csv_lines_only=csv_lines_only,
+                    execution_partition=execution_partition,
+                    sample_count=sample_count,
+                )
+
+                outputs_below_limit = not sample or not sample_count
+                if is_data_product:
+                    outputs_below_limit = outputs_below_limit or (
+                        sample_count is not None and len(data_products) < sample_count
+                    )
+                else:
+                    outputs_below_limit = outputs_below_limit or (
+                        sample_count is not None and len(outputs) < sample_count
+                    )
+
+                if outputs_below_limit:
+                    data['multi_output'] = True
+                    if is_data_product:
+                        data_products.append(data)
+                    else:
+                        outputs.append(data)
+
+    return outputs + data_products
+
+
+def handle_variables(
+    block,
+    items: List[Dict[str, Any]],
+    block_groups: Optional[
+        List[Dict[str, Union[List[str], Optional[List[Any]], Optional[str]]]]
+    ] = None,
+    block_uuid: Optional[str] = None,
+    csv_lines_only: bool = False,
+    exclude_blank_variable_uuids: bool = False,
+    execution_partition: Optional[str] = None,
+    include_print_outputs: bool = True,
+    input_data_types: Optional[List[InputDataType]] = None,
+    max_results: Optional[int] = None,
+    read_batch_settings: Optional[BatchSettings] = None,
+    read_chunks: Optional[List[ChunkKeyTypeUnion]] = None,
+    sample: bool = True,
+    sample_count: Optional[int] = None,
+    selected_variables: Optional[List[str]] = None,
+    variable_type: Optional[VariableType] = None,
+):
+    data_products = []
+    outputs = []
+
+    all_variables = []
+    variable_type_mapping = {}
+
+    if not block_groups:
+        if block.pipeline is None:
+            return []
+
+        if not block_uuid:
+            block_uuid = block.uuid
+
+        all_variables = block.get_variables_by_block(
+            block_uuid=block_uuid,
+            max_results=max_results,
+            partition=execution_partition,
+        )
+
+        if not include_print_outputs:
+            all_variables = block.output_variables(
+                execution_partition=execution_partition,
+                max_results=max_results,
+            )
+
+        block_groups = [dict(block_uuid=block_uuid, variable_uuids=all_variables)]
+
+    for idx, block_group in enumerate(block_groups):
+        b_uuid = block_group['block_uuid']
+        variable_uuids = block_group['variable_uuids'] or []
+        block_outputs = block_group.get('outputs')
+
+        for idx_inner, variable_uuid in enumerate(variable_uuids):
+
+            def __callback(
+                data_from_yield,
+                b_uuid=b_uuid,
+                block=block,
+                csv_lines_only=csv_lines_only,
+                execution_partition=execution_partition,
+                idx=idx,
+                idx_inner=idx_inner,
+                input_data_types=input_data_types,
+                read_batch_settings=read_batch_settings,
+                read_chunks=read_chunks,
+                variable_uuid=variable_uuid,
+            ):
+                data, is_data_product = format_output_data(
+                    block,
+                    data_from_yield,
+                    variable_uuid,
+                    block_uuid=b_uuid,
+                    csv_lines_only=csv_lines_only,
+                    execution_partition=execution_partition,
+                )
+
+                if is_data_product:
+                    data_products.append(((idx, idx_inner), data, is_data_product))
+                else:
+                    outputs.append(((idx, idx_inner), data, is_data_product))
+
+            if (selected_variables and variable_uuid not in selected_variables) or (
+                exclude_blank_variable_uuids and variable_uuid.strip() == ''
+            ):
+                continue
+
+            if block_outputs and idx_inner < len(block_outputs):
+                yield (block_outputs[idx_inner], sample, sample_count, __callback)
+            else:
+                variable_object = block.get_variable_object(
+                    block_uuid=b_uuid,
+                    partition=execution_partition,
+                    variable_uuid=variable_uuid,
+                    input_data_types=input_data_types,
+                    read_batch_settings=read_batch_settings,
+                    read_chunks=read_chunks,
+                )
+
+                if variable_type is not None and variable_object.variable_type != variable_type:
+                    continue
+
+                if variable_object.variable_type is not None:
+                    variable_type_mapping[variable_object.variable_type] = (
+                        variable_type_mapping.get(variable_object.variable_type, [])
+                    )
+                    variable_type_mapping[variable_object.variable_type].append(variable_uuid)
+
+                yield (variable_object, sample, sample_count, __callback)
+
+    arr = outputs + data_products
+    arr_sorted = sorted(arr, key=lambda x: x[0])
+
+    if len(data_products) >= len(outputs):
+        arr_sorted = [x[1] for x in arr_sorted]
+    else:
+        arr_sorted = [x[1] for x in arr_sorted]
+
+    if len(arr_sorted) >= 2 and any([vt for vt in variable_type_mapping.keys()]):
+        for item in arr_sorted[:DATAFRAME_SAMPLE_COUNT_PREVIEW]:
+            if isinstance(item, dict):
+                items.append(merge_dict(item, dict(multi_output=True)))
+            else:
+                items.append(item)
+    else:
+        items.extend(arr_sorted)
+
+
+def get_outputs_for_display_sync(block, **kwargs) -> List[Dict[str, Any]]:
+    items = []
+
+    for outputs in handle_variables(block, items, **kwargs):
+        variable_object, sample, sample_count, __callback = outputs
+        data = variable_object.read_data(
+            sample=sample,
+            sample_count=sample_count,
+            spark=block.get_spark_session(),
+        )
+        __callback(data)
+
+    return items
+
+
+async def get_outputs_for_display_async(block, **kwargs) -> List[Dict[str, Any]]:
+    items = []
+
+    for outputs in handle_variables(block, items, **kwargs):
+        variable_object, sample, sample_count, __callback = outputs
+        data = await variable_object.read_data_async(
+            sample=sample,
+            sample_count=sample_count,
+            spark=block.get_spark_session(),
+        )
+        __callback(data)
+
+    return items