addprop

添加自定义属性表或时间表

描述

例子

T = addprop (T,propertyNames,propertyTypes)将属性包含自定义元数据添加到表或时间表T。输入参数propertyNames指定属性的名称。对于每一个自定义属性,propertyTypes指定是否适用于中包含的元数据值属性T作为一个整体,或者变量的T

在您添加属性addprop,你可以使用点语法指定元数据的属性值。

例子

全部折叠

读取数据到一个表中。然后添加属性包含自定义元数据。

首先,测量湿度和空气质量的读入一个表。显示前三行。

T = readtable (“indoors.csv”);头(T, 3)
ans =3×3表时间湿度AirQuality ___________________ ________ __________ 2015-11-15 00:00:24 36 80 2015-11-15 01:13:35 36 80 2015-11-15 02:26:47 37 79

显示表的属性。属性对象,T.Properties存储元数据,如两个维度的名称的表和表变量的名称。所有表都这样的对象具有相同的属性。(时间表也有类似的对象,包括额外的、有时限的属性)。

T.Properties
ans = TableProperties属性:描述:“用户数据:[]DimensionNames:{“行”“变量”}VariableNames:{“时间”“湿度”“AirQuality”} VariableDescriptions: {} VariableUnits: {} VariableContinuity: [] RowNames: {} CustomProperties:没有自定义属性集。使用addprop和rmprop CustomProperties修改。

此外,您可以指定自己的属性来存储自定义元数据。例如,使用addprop函数将属性添加到表中T仪器的名称、测量精度和源文件的名称。对于每个变量有一个元数据值的属性,指定“变量”作为属性类型。属性有一个值,适用于整个表,指定“表”

T = addprop (T) {“工具”,“精度”,“源文件”},{“变量”,“变量”,“表”});T.Properties
ans = TableProperties属性:描述:“用户数据:[]DimensionNames:{“行”“变量”}VariableNames:{“时间”“湿度”“AirQuality”} VariableDescriptions: {} VariableUnits: {} VariableContinuity: [] RowNames:{}自定义属性(访问使用t.Properties.CustomProperties。<名称>):源文件:[]仪器:[]精度:[]

当您创建自定义属性使用addprop,属性是空的。存储元数据值的自定义属性,指定使用点语法。

T.Properties.CustomProperties。仪器= [“钟”“湿度计”“空气质量计”];T.Properties.CustomProperties。精度=(南0.5 - 0.1);T.Properties.CustomProperties。源文件=“indoors.csv”;T.Properties
ans = TableProperties属性:描述:“用户数据:[]DimensionNames:{“行”“变量”}VariableNames:{“时间”“湿度”“AirQuality”} VariableDescriptions: {} VariableUnits: {} VariableContinuity: [] RowNames:{}自定义属性(访问使用t.Properties.CustomProperties。<名称>):源文件:在室内。csv的工具(“钟”:“湿度计”“空气质量流量计”]精度:(南0.5000 - 0.1000)

当你分配一个数组文本值的自定义属性,最佳实践是使用一个字符串数组,而不是单元阵列的特征向量。如果您使用一个单元阵列的特征向量,然后没有机制来防止你以后分配非文本值作为单元阵列的元素。

输入参数

全部折叠

输入表,指定为一个表或时间表。

自定义属性的名称,指定为一个特征向量,单元阵列的特征向量,或字符串数组。

属性类型,指定为一个特征向量,单元阵列的特征向量,或字符串数组。为每个指定的属性名propertyNames,指定相应的属性类型“表”“变量”。属性类型的数量必须等于属性名的数量。

表描述了两种属性。

属性类型

描述

“表”

任意大小的属性包含一个值。值作为元数据适用于整个表或时间表。

“变量”

一个值的属性包含一个数组为表中的每个变量或时间表。是元数据变量的值。数组中的值必须匹配的数量变量的数量。

存储的值属性是同步变量。他们回复当你采取这些行动之一:

  • 变量,相应的值的属性会重新排序。

  • 添加变量——默认值被添加相应的属性值。

  • 删除变量——相应的值是被带离现场。

介绍了R2018b