matlab/matlab-agentic-toolkit / skills-catalog/test-and-measurement/matlab-find-pi-assets
matlab-find-pi-assets
VerifiedFind and query PI assets using MATLAB's Industrial Communication Toolbox. Two paths: (1) direct PI tag lookup via piclient + tags when user provides a tag name or description (R2022a+), (2) Asset Framework navigation via afclient when user needs element/attribute hierarchy (R2026a+). Use when working with PI AF servers, PI Data Archive tags, asset hierarchies, element templates, attribute lookup, or historical data from OSIsoft PI systems.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 24.2 KB |
| manifest.yaml | config | 504 B |
| references/key-functions.md | markdown | 3.3 KB |
references/key-functions.md
View on GitHub# Key Functions Reference
## PI Asset Identification Functions
| Function | Purpose | Toolbox |
|----------|---------|---------|
| `OSIsoft.AF.PISystems` | Enumerate available AF servers (via .NET AFSDK) | .NET interop |
| `OSIsoft.AF.PI.PIServers` | Enumerate available PI Data Archive servers (via .NET AFSDK) | .NET interop |
| `piclient` | Connect to PI Data Archive server | Industrial Communication Toolbox |
| `tags` | Search for PI tags by name pattern | Industrial Communication Toolbox |
| `read` (piclient) | Read data from PI Data Archive tags (supports DateRange, Interval, AggregateFcn) | Industrial Communication Toolbox |
| `afclient` | Connect to PI Asset Framework server | Industrial Communication Toolbox |
| `listDatabases` | List available databases on connected AF server (returns string array) | Industrial Communication Toolbox |
| `selectDatabase` | Switch AF client to a specified database | Industrial Communication Toolbox |
| `findElementByName` | Find AF elements by name (supports wildcards) | Industrial Communication Toolbox |
| `findElementByTemplate` | Find all elements of a given template | Industrial Communication Toolbox |
| `findElementByPath` | Find AF element by full path (must use string, not char) | Industrial Communication Toolbox |
| `findAttributeByPath` | Find AF attribute by full path (must use string, not char) | Industrial Communication Toolbox |
| `getAttributes` | Get attributes of an element (with optional name filter) | Industrial Communication Toolbox |
| `getChildren` | Get child elements of an element | Industrial Communication Toolbox |
| `getRootElements` | Get top-level elements in the database | Industrial Communication Toolbox |
| `read` (AF attribute) | Read current/snapshot value from an AF attribute | Industrial Communication Toolbox |
| `readHistory` | Read historical time-series data from AF attributes | Industrial Communication Toolbox |
## Attribute Properties (`icomm.af.Attribute`)
| Property | Type | Description |
|----------|------|-------------|
| `Name` | string | Attribute name |
| `Path` | string | Full path (`\\server\database\...\element|attribute`) |
| `Description` | string | Human-readable description |
| `ElementName` | string | Name of the parent element |
| `ServerDataType` | string | Data type (e.g., "Double", "String", "Int32") |
| `DefaultUnit` | string | Engineering unit (e.g., "degree Celsius", "MW") |
| `HasTimeSeriesData` | logical | Whether the attribute has time-series data |
| `ReadAccess` | logical | Whether attribute is readable |
| `WriteAccess` | logical | Whether attribute is writable |
| `Categories` | string | Semicolon-separated category list |
## Return Types
| Function | Returns | Value Column |
|----------|---------|-------------|
| `read(piObj, tagName)` (no DateRange) | timetable | string |
| `read(piObj, tagName, DateRange=...)` | timetable | double |
| `read(attr)` | table | cell (string or numeric inside) |
| `readHistory(attr, ...)` | timetable | cell (numeric inside — use `cell2mat`) |
| `tags(piObj, Name=...)` | table | Tags column is string array |
| `listDatabases(afObj)` | string array | N/A |
| `findElementByName(afObj, ...)` | Element array | N/A |
| `findElementByTemplate(afObj, ...)` | Element array | N/A |
| `getAttributes(elem, ...)` | Attribute array | N/A |
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |