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存储元数据,如表的两个维度的名称和表变量的名称。所有表都有这些具有相同属性的对象。(Timetables也有类似的对象,其中包括附加的特定于时间的属性。)

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。精度= [NaN 0.5 0.1];T.Properties.CustomProperties。源文件=“indoors.csv”;T.Properties
描述:" UserData: {'Row' 'Variables'} VariableNames: {'Time' ''潮湿'' '空气质量'}variabledescription: {} VariableUnits: {} variablecontintin: [] RowNames:{}自定义属性(访问使用的t.Properties.CustomProperties.): SourceFile: '。csv' Instrument: ["clock" "hygrometer" "air quality meter"]精度:[NaN 0.5000 0.1000]

当将文本值数组分配给自定义属性时,最佳实践是使用字符串数组,而不是字符向量的单元格数组。如果您使用字符向量的单元数组,则没有任何机制阻止您稍后将非文本值赋值为单元数组的元素。

输入参数

全部折叠

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

自定义属性的名称,指定为字符向量、字符向量的单元数组或字符串数组。

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

该表描述了这两种属性类型。

属性类型

描述

“表”

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

“变量”

该属性包含一个数组,该表或时间表中的每个变量都有一个值。这些值是变量的元数据。数组中值的数量必须与变量的数量匹配。

属性存储的值与变量同步。当你采取以下行动时,他们会做出反应:

  • 移动变量——属性中相应的值被重新排序。

  • 添加变量——默认值作为相应的值添加到属性中。

  • 删除变量——从属性中删除相应的值。

介绍了R2018b