【C#】【EXCEL】Bumblebee/Components/Analysis/GH_Ex_Ana_CondBetween.cs

本文主要是介绍【C#】【EXCEL】Bumblebee/Components/Analysis/GH_Ex_Ana_CondBetween.cs,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

这段代码定义了一个名为 GH_Ex_Ana_CondBetween 的 Grasshopper 组件,其主要功能是为 Excel 工作表中的特定范围添加条件格式。具体来说:

  1. 功能概述:

    • 为 Excel 中的数据范围添加基于区间值的条件格式
    • 允许用户自定义高亮颜色
    • 提供选项来反转条件(高亮区间外的值)
    • 可以清除现有的条件格式
    • 可以控制是否激活条件格式
  2. 输入参数:

    • 工作表数据
    • 范围数据
    • 区间(用于评估的数值范围)
    • 单元格颜色
    • 是否反转条件
    • 是否清除现有条件
    • 是否激活条件格式
  3. 输出:

    • 处理后的 Excel 范围对象
  4. 组件特性:

    • 作为次要组件显示在 Grasshopper 界面中
    • 具有自定义图标
    • 有唯一的组件标识符(GUID)
  5. 使用场景:
    这个组件适用于需要在 Grasshopper 中处理 Excel 数据的情况,特别是当用户想要突出显示落在特定数值区间内(或外)的数据时。它可以帮助用户快速识别符合特定条件的数据,提高数据分析和可视化的效率。

  6. 代码结构:

    • 继承自基础范围组件 (GH_Ex_Rng__Base)
    • 重写了多个方法来自定义组件行为
    • 使用 SolveInstance 方法实现主要逻辑
  7. 扩展性:
    这个组件展示了如何将 Excel 的高级功能集成到 Grasshopper 中,为数据分析和可视化提供了更多可能性。类似的方法可以用于创建其他类型的 Excel 数据处理组件。

总的来说,这个组件为 Grasshopper 用户提供了一种灵活的方式来对 Excel 数据应用条件格式,特别是基于数值区间的格式。它体现了将 Excel 的强大功能与 Grasshopper 的参数化设计能力相结合的潜力,为建筑、工程等领域的专业人士提供了更强大的数据处理和可视化工具。

Flow diagram

成功 / Success
失败 / Failure
成功 / Success
失败 / Failure
是 / Yes
否 / No
是 / Yes
否 / No
开始 / Start
初始化参数 / Initialize Parameters
获取工作表数据 / Get Worksheet Data
获取范围数据 / Get Range Data
结束 / End
获取其他输入参数 / Get Other Input Parameters
是否激活条件? / Activate Condition?
是否清除现有条件? / Clear Existing Conditions?
设置输出数据 / Set Output Data
清除条件 / Clear Conditions
添加条件格式 / Add Conditional Formatting

这个流程图对应到代码中的主要步骤如下:

  1. 开始 (Start): 对应 SolveInstance 方法的开始。
  2. 初始化参数 (Initialize Parameters): 对应方法开始时的变量声明。
  3. 获取工作表数据 (Get Worksheet Data): 对应 DA.GetData(0, ref gooS) 和相关处理。
  4. 获取范围数据 (Get Range Data): 对应 DA.GetData(1, ref gooR) 和相关处理。
  5. 获取其他输入参数 (Get Other Input Parameters): 对应获取间隔、颜色、翻转、清除和激活等参数的代码。
  6. 是否激活条件? (Activate Condition?): 对应 if (activate) 条件判断。
  7. 是否清除现有条件? (Clear Existing Conditions?): 对应 if (clear) 条件判断。
  8. 清除条件 (Clear Conditions): 对应 range.ClearConditions() 调用。
  9. 添加条件格式 (Add Conditional Formatting): 对应 range.AddConditionalBetween() 调用。
  10. 设置输出数据 (Set Output Data): 对应 DA.SetData(0, range) 调用。
  11. 结束 (End): 对应方法的结束。

这个流程图清晰地展示了代码的主要逻辑流程,包括数据获取、条件判断和操作执行的顺序。

Description

  1. 构造函数 GH_Ex_Ana_CondBetween()
public GH_Ex_Ana_CondBetween(): base("Conditional Between", "Between","Add conditional formatting to a Range for values between two numbers",Constants.ShortName, Constants.SubAnalysis)
{
}

解释:
这是组件的构造函数。它调用基类构造函数,设置组件的名称、昵称、描述和分类。初始化条件格式(区间)组件,设置其基本信息。
Initializes the Conditional Between component, setting its basic information.

  1. Exposure 属性
public override GH_Exposure Exposure
{get { return GH_Exposure.secondary; }
}

解释:
设置组件在 Grasshopper 界面中的显示级别。将组件设置为次要显示级别,通常在子菜单中显示。
Sets the component to secondary exposure level, typically displayed in a submenu.

  1. RegisterInputParams 方法
protected override void RegisterInputParams(GH_Component.GH_InputParamManager pManager)
{base.RegisterInputParams(pManager);pManager[1].Optional = true;pManager.AddIntervalParameter("Domain", "D", "The domain to evaluate", GH_ParamAccess.item);pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray);// ... 其他参数注册
}

解释:
注册组件的输入参数。调用基类方法注册基本参数,然后添加特定于此组件的参数。定义组件所需的输入数据,如区间、颜色、条件设置等。
Defines the input data required by the component, such as interval, color, condition settings, etc.

  1. RegisterOutputParams 方法
protected override void RegisterOutputParams(GH_Component.GH_OutputParamManager pManager)
{base.RegisterOutputParams(pManager);
}

解释:
注册组件的输出参数。这里直接调用基类方法,表明输出与基类相同。定义组件的输出数据,在这里与基类输出相同。
Defines the output data of the component, which is the same as the base class in this case.

  1. SolveInstance 方法
protected override void SolveInstance(IGH_DataAccess DA)
{// 获取工作表数据IGH_Goo gooS = null;DA.GetData(0, ref gooS);ExWorksheet worksheet = new ExWorksheet();bool hasWs = gooS.TryGetWorksheet(ref worksheet);// 获取范围数据IGH_Goo gooR = null;DA.GetData(1, ref gooR);ExRange range = new ExRange();if (!gooR.TryGetRange(ref range, worksheet)) return;if (!hasWs) worksheet = range.Worksheet;// 获取其他参数Interval interval = new Interval();if (!DA.GetData(2, ref interval)) return;Sd.Color color = Sd.Color.LightGray;DA.GetData(3, ref color);// ... 获取其他参数// 应用条件格式if (activate){if (clear) range.ClearConditions();range.AddConditionalBetween(interval.Min, interval.Max, color, flip);}// 设置输出DA.SetData(0, range);
}

解释:
这是组件的核心方法,执行实际的数据处理。依次获取输入数据,处理工作表和范围信息,然后根据设置应用条件格式。
Sequentially retrieves input data, processes worksheet and range information, then applies conditional formatting based on settings.
关键步骤包括:

  1. 获取并验证工作表和范围数据

  2. 获取条件格式的参数(区间、颜色等)

  3. 根据激活状态决定是否应用条件格式

  4. 如果需要,清除现有条件并添加新的条件格式

  5. 输出处理后的范围对象

  6. Icon 属性

protected override System.Drawing.Bitmap Icon
{get{return Properties.Resources.BB_Cond_Between_01;}
}

解释:
提供组件的图标。返回组件在 Grasshopper 界面中显示的自定义图标。
Returns the custom icon displayed for the component in the Grasshopper interface.

  1. ComponentGuid 属性
public override Guid ComponentGuid
{get { return new Guid("bd35ec14-ab24-4bbf-99ae-38ccc3d4a6da"); }
}

解释:
定义组件的唯一标识符。返回组件的唯一 GUID,用于 Grasshopper 内部识别和管理。
Returns the unique GUID of the component, used for internal identification and management in Grasshopper.

总结:
这个组件展示了如何创建一个自定义的 Grasshopper 组件,用于在 Excel 范围内应用条件格式。它demonstrates了参数注册、数据处理和 Excel 操作的集成。通过这种方式,开发者可以扩展 Grasshopper 的功能,为用户提供更强大的数据分析和可视化工具。

Code

using Grasshopper.Kernel;
using Grasshopper.Kernel.Parameters;
using Grasshopper.Kernel.Types;
using Rhino.Geometry;
using System;
using System.Collections.Generic;
using Sd = System.Drawing;namespace Bumblebee.Components
{// 定义一个条件格式(区间)组件类,继承自基础范围组件public class GH_Ex_Ana_CondBetween : GH_Ex_Rng__Base{/// <summary>/// 初始化 GH_Ex_An_CondBetween 类的新实例/// </summary>public GH_Ex_Ana_CondBetween(): base("Conditional Between", "Between","Add conditional formatting to a Range for values between two numbers",Constants.ShortName, Constants.SubAnalysis){// 构造函数:设置组件的名称、昵称、描述和分类}/// <summary>/// 设置组件的显示级别/// </summary>public override GH_Exposure Exposure{get { return GH_Exposure.secondary; } // 将组件设置为次要显示级别}/// <summary>/// 注册所有输入参数/// </summary>protected override void RegisterInputParams(GH_Component.GH_InputParamManager pManager){base.RegisterInputParams(pManager); // 调用基类方法注册基本参数pManager[1].Optional = true; // 设置第二个参数为可选pManager.AddIntervalParameter("Domain", "D", "The domain to evaluate", GH_ParamAccess.item); // 添加区间参数pManager.AddColourParameter("Cell Color", "C", "The cell highlight color", GH_ParamAccess.item, Sd.Color.LightGray); // 添加颜色参数,默认为浅灰色pManager[3].Optional = true; // 设置为可选pManager.AddBooleanParameter("Flip", "F", "If true, non unique values will be highlighted", GH_ParamAccess.item, false); // 添加翻转参数pManager[4].Optional = true; // 设置为可选pManager.AddBooleanParameter("Clear", "_X", "If true, the existing conditions will be cleared", GH_ParamAccess.item, false); // 添加清除条件参数pManager[5].Optional = true; // 设置为可选pManager.AddBooleanParameter("Activate", "_A", "If true, the condition will be applied", GH_ParamAccess.item, false); // 添加激活条件参数pManager[6].Optional = true; // 设置为可选}/// <summary>/// 注册所有输出参数/// </summary>protected override void RegisterOutputParams(GH_Component.GH_OutputParamManager pManager){base.RegisterOutputParams(pManager); // 调用基类方法注册输出参数}/// <summary>/// 实际执行工作的方法/// </summary>/// <param name="DA">用于检索输入和存储输出的 DA 对象</param>protected override void SolveInstance(IGH_DataAccess DA){IGH_Goo gooS = null;DA.GetData(0, ref gooS); // 获取工作表数据ExWorksheet worksheet = new ExWorksheet();bool hasWs = gooS.TryGetWorksheet(ref worksheet); // 尝试获取工作表IGH_Goo gooR = null;DA.GetData(1, ref gooR); // 获取范围数据ExRange range = new ExRange();if (!gooR.TryGetRange(ref range, worksheet)) return; // 尝试获取范围,如果失败则返回if (!hasWs) worksheet = range.Worksheet; // 如果之前没有获取到工作表,从范围中获取Interval interval = new Interval();if (!DA.GetData(2, ref interval)) return; // 获取区间数据Sd.Color color = Sd.Color.LightGray;DA.GetData(3, ref color); // 获取颜色数据bool flip = false;DA.GetData(4, ref flip); // 获取是否翻转bool clear = false;DA.GetData(5, ref clear); // 获取是否清除现有条件bool activate = false;DA.GetData(6, ref activate); // 获取是否激活条件if (activate){if (clear) range.ClearConditions(); // 如果需要清除,则清除现有条件range.AddConditionalBetween(interval.Min, interval.Max, color, flip); // 添加条件格式}DA.SetData(0, range); // 设置输出数据}/// <summary>/// 提供组件的图标/// </summary>protected override System.Drawing.Bitmap Icon{get{// 你可以将图像文件添加到项目资源中并像这样访问它们:// return Resources.IconForThisComponent;return Properties.Resources.BB_Cond_Between_01;}}/// <summary>/// 获取此组件的唯一 ID。发布后不要更改此 ID。/// </summary>public override Guid ComponentGuid{get { return new Guid("bd35ec14-ab24-4bbf-99ae-38ccc3d4a6da"); }}}
}

这篇关于【C#】【EXCEL】Bumblebee/Components/Analysis/GH_Ex_Ana_CondBetween.cs的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/1107106

相关文章

C#代码实现解析WTGPS和BD数据

《C#代码实现解析WTGPS和BD数据》在现代的导航与定位应用中,准确解析GPS和北斗(BD)等卫星定位数据至关重要,本文将使用C#语言实现解析WTGPS和BD数据,需要的可以了解下... 目录一、代码结构概览1. 核心解析方法2. 位置信息解析3. 经纬度转换方法4. 日期和时间戳解析5. 辅助方法二、L

使用C#删除Excel表格中的重复行数据的代码详解

《使用C#删除Excel表格中的重复行数据的代码详解》重复行是指在Excel表格中完全相同的多行数据,删除这些重复行至关重要,因为它们不仅会干扰数据分析,还可能导致错误的决策和结论,所以本文给大家介绍... 目录简介使用工具C# 删除Excel工作表中的重复行语法工作原理实现代码C# 删除指定Excel单元

Python实现pdf电子发票信息提取到excel表格

《Python实现pdf电子发票信息提取到excel表格》这篇文章主要为大家详细介绍了如何使用Python实现pdf电子发票信息提取并保存到excel表格,文中的示例代码讲解详细,感兴趣的小伙伴可以跟... 目录应用场景详细代码步骤总结优化应用场景电子发票信息提取系统主要应用于以下场景:企业财务部门:需

Python处理大量Excel文件的十个技巧分享

《Python处理大量Excel文件的十个技巧分享》每天被大量Excel文件折磨的你看过来!这是一份Python程序员整理的实用技巧,不说废话,直接上干货,文章通过代码示例讲解的非常详细,需要的朋友可... 目录一、批量读取多个Excel文件二、选择性读取工作表和列三、自动调整格式和样式四、智能数据清洗五、

C#使用MQTTnet实现服务端与客户端的通讯的示例

《C#使用MQTTnet实现服务端与客户端的通讯的示例》本文主要介绍了C#使用MQTTnet实现服务端与客户端的通讯的示例,包括协议特性、连接管理、QoS机制和安全策略,具有一定的参考价值,感兴趣的可... 目录一、MQTT 协议简介二、MQTT 协议核心特性三、MQTTNET 库的核心功能四、服务端(BR

Python Pandas高效处理Excel数据完整指南

《PythonPandas高效处理Excel数据完整指南》在数据驱动的时代,Excel仍是大量企业存储核心数据的工具,Python的Pandas库凭借其向量化计算、内存优化和丰富的数据处理接口,成为... 目录一、环境搭建与数据读取1.1 基础环境配置1.2 数据高效载入技巧二、数据清洗核心战术2.1 缺失

C#继承之里氏替换原则分析

《C#继承之里氏替换原则分析》:本文主要介绍C#继承之里氏替换原则,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录C#里氏替换原则一.概念二.语法表现三.类型检查与转换总结C#里氏替换原则一.概念里氏替换原则是面向对象设计的基本原则之一:核心思想:所有引py

利用Python实现Excel文件智能合并工具

《利用Python实现Excel文件智能合并工具》有时候,我们需要将多个Excel文件按照特定顺序合并成一个文件,这样可以更方便地进行后续的数据处理和分析,下面我们看看如何使用Python实现Exce... 目录运行结果为什么需要这个工具技术实现工具的核心功能代码解析使用示例工具优化与扩展有时候,我们需要将

C#实现访问远程硬盘的图文教程

《C#实现访问远程硬盘的图文教程》在现实场景中,我们经常用到远程桌面功能,而在某些场景下,我们需要使用类似的远程硬盘功能,这样能非常方便地操作对方电脑磁盘的目录、以及传送文件,这次我们将给出一个完整的... 目录引言一. 远程硬盘功能展示二. 远程硬盘代码实现1. 底层业务通信实现2. UI 实现三. De

C#通过进程调用外部应用的实现示例

《C#通过进程调用外部应用的实现示例》本文主要介绍了C#通过进程调用外部应用的实现示例,以WINFORM应用程序为例,在C#应用程序中调用PYTHON程序,具有一定的参考价值,感兴趣的可以了解一下... 目录窗口程序类进程信息类 系统设置类 以WINFORM应用程序为例,在C#应用程序中调用python程序