diff --git a/README.md b/README.md index 0c1d9b1..02b6d06 100644 --- a/README.md +++ b/README.md @@ -4,83 +4,86 @@ # Uni-Lab-OS + +**English** | [中文](README_zh.md) + [![GitHub Stars](https://img.shields.io/github/stars/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/network/members) [![GitHub Issues](https://img.shields.io/github/issues/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/issues) [![GitHub License](https://img.shields.io/github/license/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/blob/main/LICENSE) -Uni-Lab 操作系统是一个用于实验室自动化的综合平台，旨在连接和控制各种实验设备，实现实验流程的自动化和标准化。 +Uni-Lab Operating System is a platform for laboratory automation, designed to connect and control various experimental equipment, enabling automation and standardization of experimental workflows. -## 核心特点 +## Key Features -- 多设备集成管理 -- 自动化实验流程 -- 云端连接能力 -- 灵活的配置系统 -- 支持多种实验协议 +- Multi-device integration management +- Automated experimental workflows +- Cloud connectivity capabilities +- Flexible configuration system +- Support for multiple experimental protocols -## 文档 +## Documentation -详细文档可在以下位置找到: +Detailed documentation can be found at: -- [在线文档](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/) +- [Online Documentation](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/) -## 快速开始 +## Quick Start -1. 配置Conda环境 +1. Configure Conda Environment -Uni-Lab-OS 建议使用 `mamba` 管理环境。根据您的操作系统选择适当的环境文件: +Uni-Lab-OS recommends using `mamba` for environment management. Choose the appropriate environment file for your operating system: ```bash -# 创建新环境 +# Create new environment mamba env create -f unilabos-[YOUR_OS].yaml mamba activate unilab -# 或更新现有环境 -# 其中 `[YOUR_OS]` 可以是 `win64`, `linux-64`, `osx-64`, 或 `osx-arm64`。 -conda env update --file unilabos-[YOUR_OS].yml -n 环境名 +# Or update existing environment +# Where `[YOUR_OS]` can be `win64`, `linux-64`, `osx-64`, or `osx-arm64`. +conda env update --file unilabos-[YOUR_OS].yml -n environment_name -# 现阶段，需要安装 `unilabos_msgs` 包 -# 可以前往 Release 页面下载系统对应的包进行安装 +# Currently, you need to install the `unilabos_msgs` package +# You can download the system-specific package from the Release page conda install ros-humble-unilabos-msgs-0.9.0-xxxxx.tar.bz2 -# 安装PyLabRobot等前置 +# Install PyLabRobot and other prerequisites git clone https://github.com/PyLabRobot/pylabrobot plr_repo cd plr_repo pip install .[opentrons] ``` -2. 安装 Uni-Lab-OS: +2. Install Uni-Lab-OS: ```bash -# 克隆仓库 +# Clone the repository git clone https://github.com/dptech-corp/Uni-Lab-OS.git cd Uni-Lab-OS -# 安装 Uni-Lab-OS +# Install Uni-Lab-OS pip install . ``` -3. 启动 Uni-Lab 系统: +3. Start Uni-Lab System: -请见[文档-启动样例](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/boot_examples/index.html) +Please refer to [Documentation - Boot Examples](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/boot_examples/index.html) -## 消息格式 +## Message Format -Uni-Lab-OS 使用预构建的 `unilabos_msgs` 进行系统通信。您可以在 [GitHub Releases](https://github.com/dptech-corp/Uni-Lab-OS/releases) 页面找到已构建的版本。 +Uni-Lab-OS uses pre-built `unilabos_msgs` for system communication. You can find the built versions on the [GitHub Releases](https://github.com/dptech-corp/Uni-Lab-OS/releases) page. -## 许可证 +## License -此项目采用 GPL-3.0 许可 - 详情请参阅 [LICENSE](LICENSE) 文件。 +This project is licensed under GPL-3.0 - see the [LICENSE](LICENSE) file for details. -## 项目统计 +## Project Statistics -### Stars 趋势 +### Stars Trend Star History Chart -## 联系我们 +## Contact Us - GitHub Issues: [https://github.com/dptech-corp/Uni-Lab-OS/issues](https://github.com/dptech-corp/Uni-Lab-OS/issues) \ No newline at end of file diff --git a/README_zh.md b/README_zh.md new file mode 100644 index 0000000..ce660cd --- /dev/null +++ b/README_zh.md @@ -0,0 +1,89 @@ +
+ Uni-Lab Logo +
+ +# Uni-Lab-OS + + +[English](README.md) | **中文** + +[![GitHub Stars](https://img.shields.io/github/stars/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/stargazers) +[![GitHub Forks](https://img.shields.io/github/forks/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/network/members) +[![GitHub Issues](https://img.shields.io/github/issues/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/issues) +[![GitHub License](https://img.shields.io/github/license/dptech-corp/Uni-Lab-OS.svg)](https://github.com/dptech-corp/Uni-Lab-OS/blob/main/LICENSE) + +Uni-Lab 操作系统是一个用于实验室自动化的综合平台，旨在连接和控制各种实验设备，实现实验流程的自动化和标准化。 + +## 核心特点 + +- 多设备集成管理 +- 自动化实验流程 +- 云端连接能力 +- 灵活的配置系统 +- 支持多种实验协议 + +## 文档 + +详细文档可在以下位置找到: + +- [在线文档](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/) + +## 快速开始 + +1. 配置Conda环境 + +Uni-Lab-OS 建议使用 `mamba` 管理环境。根据您的操作系统选择适当的环境文件: + +```bash +# 创建新环境 +mamba env create -f unilabos-[YOUR_OS].yaml +mamba activate unilab + +# 或更新现有环境 +# 其中 `[YOUR_OS]` 可以是 `win64`, `linux-64`, `osx-64`, 或 `osx-arm64`。 +conda env update --file unilabos-[YOUR_OS].yml -n 环境名 + +# 现阶段，需要安装 `unilabos_msgs` 包 +# 可以前往 Release 页面下载系统对应的包进行安装 +conda install ros-humble-unilabos-msgs-0.9.0-xxxxx.tar.bz2 + +# 安装PyLabRobot等前置 +git clone https://github.com/PyLabRobot/pylabrobot plr_repo +cd plr_repo +pip install .[opentrons] +``` + +2. 安装 Uni-Lab-OS: + +```bash +# 克隆仓库 +git clone https://github.com/dptech-corp/Uni-Lab-OS.git +cd Uni-Lab-OS + +# 安装 Uni-Lab-OS +pip install . +``` + +3. 启动 Uni-Lab 系统: + +请见[文档-启动样例](https://readthedocs.dp.tech/Uni-Lab/v0.8.0/boot_examples/index.html) + +## 消息格式 + +Uni-Lab-OS 使用预构建的 `unilabos_msgs` 进行系统通信。您可以在 [GitHub Releases](https://github.com/dptech-corp/Uni-Lab-OS/releases) 页面找到已构建的版本。 + +## 许可证 + +此项目采用 GPL-3.0 许可 - 详情请参阅 [LICENSE](LICENSE) 文件。 + +## 项目统计 + +### Stars 趋势 + + + Star History Chart + + +## 联系我们 + +- GitHub Issues: [https://github.com/dptech-corp/Uni-Lab-OS/issues](https://github.com/dptech-corp/Uni-Lab-OS/issues) \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerAddLiquid.action b/unilabos_msgs/action/DPLiquidHandlerAddLiquid.action deleted file mode 100644 index 0611b27..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerAddLiquid.action +++ /dev/null @@ -1,20 +0,0 @@ -float64[] asp_vols -float64[] dis_vols -Resource[] reagent_sources -Resource[] targets -int32[] use_channels -float64[] flow_rates -geometry_msgs/Point[] offsets -float64[] liquid_height -float64[] blow_out_air_volume -string spread -bool is_96_well -int32 mix_time -int32 mix_vol -int32 mix_rate -float64 mix_liquid_height -string[] none_keys ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerCustomDelay.action b/unilabos_msgs/action/DPLiquidHandlerCustomDelay.action deleted file mode 100644 index 29f9b45..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerCustomDelay.action +++ /dev/null @@ -1,6 +0,0 @@ -float64 seconds -string msg ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerMix.action b/unilabos_msgs/action/DPLiquidHandlerMix.action deleted file mode 100644 index 81d1b71..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerMix.action +++ /dev/null @@ -1,11 +0,0 @@ -Resource[] targets -int32 mix_time -int32 mix_vol -float64 height_to_bottom -geometry_msgs/Point[] offsets -float64 mix_rate -string[] none_keys ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerMoveTo.action b/unilabos_msgs/action/DPLiquidHandlerMoveTo.action deleted file mode 100644 index 740d0fc..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerMoveTo.action +++ /dev/null @@ -1,7 +0,0 @@ -Resource well -float64 dis_to_top -int32 channel ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerRemoveLiquid.action b/unilabos_msgs/action/DPLiquidHandlerRemoveLiquid.action deleted file mode 100644 index e6b43c5..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerRemoveLiquid.action +++ /dev/null @@ -1,17 +0,0 @@ -float64[] vols -Resource[] sources -Resource waste_liquid -int32[] use_channels -float64[] flow_rates -geometry_msgs/Point[] offsets -float64[] liquid_height -float64[] blow_out_air_volume -string spread -int32[] delays -bool is_96_well -float64[] top -string[] none_keys ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerSetTiprack.action b/unilabos_msgs/action/DPLiquidHandlerSetTiprack.action deleted file mode 100644 index 437d3e3..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerSetTiprack.action +++ /dev/null @@ -1,5 +0,0 @@ -Resource[] tip_racks ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerTouchTip.action b/unilabos_msgs/action/DPLiquidHandlerTouchTip.action deleted file mode 100644 index e0c3104..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerTouchTip.action +++ /dev/null @@ -1,5 +0,0 @@ -Resource[] targets ---- -bool success ---- -# 反馈 \ No newline at end of file diff --git a/unilabos_msgs/action/DPLiquidHandlerTransferLiquid.action b/unilabos_msgs/action/DPLiquidHandlerTransferLiquid.action deleted file mode 100644 index 39df59b..0000000 --- a/unilabos_msgs/action/DPLiquidHandlerTransferLiquid.action +++ /dev/null @@ -1,25 +0,0 @@ -float64[] asp_vols -float64[] dis_vols -Resource[] sources -Resource[] targets -Resource[] tip_racks -int32[] use_channels -float64[] asp_flow_rates -float64[] dis_flow_rates -geometry_msgs/Point[] offsets -bool touch_tip -float64[] liquid_height -float64[] blow_out_air_volume -string spread -bool is_96_well -string mix_stage -int32[] mix_times -int32 mix_vol -int32 mix_rate -float64 mix_liquid_height -int32[] delays -string[] none_keys ---- -bool success ---- -# 反馈 \ No newline at end of file