episodes-platform/shared-snippets
3
0
Fork 1
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update docs by adding link to catalog format documentation

Browse Source
This commit is contained in:
Mieszko Makuch 2024-08-29 13:51:45 +02:00
parent 221d8ba37a
commit 5b65058b89
4 changed files with 18 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
matlab/catalog/eliminateEmptyValues.m
View File

@ -15,6 +15,10 @@ function varargout = eliminateEmptyValues(varargin)
% arrays, and the function will remove entries that are empty in any of % arrays, and the function will remove entries that are empty in any of
% the input columns. % the input columns.
% %
% This function is designed to work with catalog objects. For more
% information about the catalog format, refer to the documentation:
% https://docs.cyfronet.pl/display/ISDOC/Catalog+-+description
%
% Example: % Example:
% [a, b] = eliminateEmptyValues([1, NaN, 3], {'A', '', 'C'}); % [a, b] = eliminateEmptyValues([1, NaN, 3], {'A', '', 'C'});
% % Result: a = [1, 3], b = {'A', 'C'} % % Result: a = [1, 3], b = {'A', 'C'}

6
matlab/catalog/extractColumns.m
View File

@ -14,6 +14,9 @@ function [varargout] = extractColumns(catalog, varargin)
% each structure has fields 'field' and 'val'. The function returns the % each structure has fields 'field' and 'val'. The function returns the
% values of the requested columns. % values of the requested columns.
% %
% For more details on the catalog format, see:
% https://docs.cyfronet.pl/display/ISDOC/Catalog+-+description
%
% Example: % Example:
% catalog(1).field = 'ID'; catalog(1).val = [1, 2, 3]; % catalog(1).field = 'ID'; catalog(1).val = [1, 2, 3];
% catalog(2).field = 'Time'; catalog(2).val = [100, 200, 300]; % catalog(2).field = 'Time'; catalog(2).val = [100, 200, 300];
@ -34,6 +37,9 @@ function column = findColumn(catalog, colName)
% column = FINDCOLUMN(catalog, colName) searches the catalog structure % column = FINDCOLUMN(catalog, colName) searches the catalog structure
% for the specified column name and returns its values. If the column % for the specified column name and returns its values. If the column
% does not exist, an error is thrown. % does not exist, an error is thrown.
%
% Refer to the catalog documentation for further information:
% https://docs.cyfronet.pl/display/ISDOC/Catalog+-+description
for c = 1:length(catalog) for c = 1:length(catalog)
if strcmp(catalog(c).field, colName) if strcmp(catalog(c).field, colName)

3
matlab/catalog/findCatalogColumn.m
View File

@ -16,6 +16,9 @@ function columnIdx = findCatalogColumn(catalog, colName)
% idx = findCatalogColumn(catalog, 'Time'); % idx = findCatalogColumn(catalog, 'Time');
% % Result: idx = 2 % % Result: idx = 2
% %
% For more details on the catalog format, refer to the documentation:
% https://docs.cyfronet.pl/display/ISDOC/Catalog+-+description
%
% Note: This function is intended to be used in conjunction with other % Note: This function is intended to be used in conjunction with other
% catalog processing functions. % catalog processing functions.
% %

6
matlab/catalog/sortByTime.m
View File

@ -4,7 +4,7 @@
% ----------------- % -----------------
% %
function [sortedCatalog] = sortByTime(catalog) function [sortedCatalog] = sortByTime(catalog)
% SORTBYTIME Sorts a catalog structure by the 'Time' column % SORTBYTIME Sorts a seismic catalog structure by the 'Time' column
% %
% sortedCatalog = SORTBYTIME(catalog) sorts the given catalog structure % sortedCatalog = SORTBYTIME(catalog) sorts the given catalog structure
% based on the values in the 'Time' column. The catalog is expected to be % based on the values in the 'Time' column. The catalog is expected to be
@ -12,6 +12,10 @@ function [sortedCatalog] = sortByTime(catalog)
% 'val'. The function rearranges the catalog entries in ascending order % 'val'. The function rearranges the catalog entries in ascending order
% of time. % of time.
% %
% This function is specific to seismic catalogs. For more general
% information on catalogs, refer to:
% https://docs.cyfronet.pl/display/ISDOC/Catalog+-+description
%
% Example: % Example:
% catalog(1).field = 'ID'; catalog(1).val = [3, 2, 1]; % catalog(1).field = 'ID'; catalog(1).val = [3, 2, 1];
% catalog(2).field = 'Time'; catalog(2).val = [300, 200, 100]; % catalog(2).field = 'Time'; catalog(2).val = [300, 200, 100];