主要内容

addprop.

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

描述

例子

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

使用“使用属性”之后addprop.,您可以使用点语法为属性分配元数据值。

例子

全部收缩

将数据读入表格。然后添加属性以包含自定义元数据。

首先,将湿度和空气质量的测量读入桌子。显示前三行。

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

显示表的属性。属性对象,T.properties.,存储元数据,例如表的两个维度的名称以及表变量的名称。所有表都有具有相同属性的这些对象。(时间表也具有类似的对象,包括其他特定于时间的属性。)

T.properties.
ans = TableProperties with properties: Description: " UserData: [] DimensionNames: {'Row' 'Variables'} VariableNames: {'Time' '湿度'' AirQuality'} VariableDescriptions: {} VariableUnits: {} variableccontinuity: [] 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.instrument = [“钟”“湿度计”“空气质量计”];t.properties.customproperties.precision = [NaN 0.5 0.1];t.properties.customproperties.sourcefile =“indoors.csv”;T.properties.
ANS =具有属性的TableProperties:Description:'''''userdata:[] dimensionnames:{'行'变量'} variablenames:{'time'''湿度'的空气质量'} variadescriptions:{}变量:{} variablecontinuity:[] Rowname:{}自定义属性(使用t.properties.customproperties访问。):sourcefile:'invoors.csv'仪器:[“时钟”“湿度计”“空气质量表”]精度:[NaN 0.5000 0.1000]

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

输入参数

全部收缩

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

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

属性类型,指定为字符向量、字符向量的单元格数组或字符串数组。指定的每个属性名财产名行员,指定相应的属性类型“表”'多变的'.属性类型的数量必须等于属性名称的数量。

该表描述了两个属性类型。

属性类型

描述

“表”

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

'多变的'

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

属性存储的值与变量同步。当你采取其中一个行动时,他们回应:

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

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

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

在R2018B中介绍