tkdatafile プログラム仕様
概要: データファイル操作のためのクラスとユーティリティを提供します。 詳細説明: このモジュールは、構造化されたデータファイル（ラベルとデータリストの形式）を読み込み、検索、操作するための
`tkDataFile`クラスを提供します。ファイルからデータを効率的に抽出し、管理するための機能が含まれています。
関連リンク: tkdatafile.py ライブラリ技術ドキュメント
- class tklib.tkdatafile.tkDataFile(path=None, mode='r', OpenFile=True, **args)[ソース]
ベースクラス:
tkFile概要: ラベルとデータリストを持つデータファイルを扱うためのクラス。 詳細説明: `tkFile`を継承し、データファイルの読み込み、ラベルの検索、データ配列の取得などの機能を提供します。
主に、行がデータアイテム、列がその属性に対応するような表形式のデータを扱います。
- FindDataArray(regexp, flag=None, flags='')[ソース]
概要: find_data_array`のラッパー。 詳細説明: `find_data_array`メソッドと同じ機能を提供し、後方互換性または異なる命名規則のために使用されます。 :param regexp: str or int: 検索する正規表現、またはラベルのインデックス。 :param flag: str or None, optional: 互換性のためのフラグ ('i' は大文字小文字無視)。`flags`引数に優先されます。 :param flags: str, optional: 検索フラグ ('i' は大文字小文字無視)。デフォルトは `''。 :returns: tuple[str or None, list or None]: 見つかったラベルとデータ配列のタプル。
見つからなかった場合は (None, None)。
- FindLabelIndex(regexp, flag=None, flags='')[ソース]
概要: find_label_index`のラッパー。 詳細説明: `find_label_index`メソッドと同じ機能を提供し、後方互換性または異なる命名規則のために使用されます。 :param regexp: str or int: 検索する正規表現、またはラベルのインデックス。 :param flag: str or None, optional: 互換性のためのフラグ ('i' は大文字小文字無視)。`flags`引数に優先されます。 :param flags: str, optional: 検索フラグ ('i' は大文字小文字無視)。デフォルトは `''。 :returns: int or None: 見つかったラベルのインデックス。見つからなかった場合は None。
- GetArrayData(idx)[ソース]
概要: (未実装) 指定されたインデックスの配列データを取得します。 詳細説明: 現在このメソッドは実装されておらず、`pass`のみが含まれています。 :param idx: int: 取得するデータのインデックス。
- find_data_array(regexp, flag=None, flags='', convert_type=None, def_val=None)[ソース]
概要: 指定された正規表現またはインデックスに一致するラベルとデータ配列を見つけます。 詳細説明: `find_label_index`を使用してラベルのインデックスを特定し、そのインデックスに対応する
ラベルとデータ配列を返します。必要に応じてデータ配列の要素を指定された型に変換します。 例えば、文字列の数値データを整数や浮動小数点数に変換できます。
- パラメータ:
regexp -- str or int: 検索する正規表現、またはラベルのインデックス。
flag -- str or None, optional: 互換性のためのフラグ ('i' は大文字小文字無視)。`flags`引数に優先されます。
flags -- str, optional: 検索フラグ ('i' は大文字小文字無視)。デフォルトは ''。
convert_type -- type or None, optional: データ配列の要素を変換する型 (例: int, float)。デフォルトは None。
def_val -- any, optional: 変換に失敗した場合に使用するデフォルト値。
- 戻り値:
tuple[str or None, list or None]: 見つかったラベルとデータ配列のタプル。 見つからなかった場合は (None, None)。 `convert_type`が指定されている場合は、変換されたデータ配列が返されます。
- find_label_index(regexp, flag=None, flags='')[ソース]
概要: 指定された正規表現またはインデックスに一致するラベルのインデックスを見つけます。 詳細説明: `labelarray`内のラベルを検索し、一致するもののインデックスを返します。
正規表現、数値インデックス、または文字列として解釈可能な数値を受け入れます。 大文字小文字の区別を無視するオプション ('i' フラグ) や、スペース、括弧を削除して比較するロジックも含まれます。
- パラメータ:
regexp -- str or int: 検索する正規表現、またはラベルのインデックス。
flag -- str or None, optional: 互換性のためのフラグ ('i' は大文字小文字無視)。`flags`引数に優先されます。
flags -- str, optional: 検索フラグ ('i' は大文字小文字無視)。デフォルトは ''。
- 戻り値:
int or None: 見つかったラベルのインデックス。見つからなかった場合は None。
- read_data(idata=[], flags='', convert_type=None, def_val=None, is_print=True)[ソース]
概要: 複数のデータ項目を読み込み、それぞれのラベルとデータリストを返します。 詳細説明: `idata`リストで指定された各項目について`find_data_array`を呼び出し、
対応するラベルとデータリストを収集します。これにより、複数のデータ列を一度に効率的に取得できます。
- パラメータ:
idata -- list[str or int], optional: 読み込むデータのインデックスまたは正規表現のリスト。デフォルトは空のリスト。
flags -- str, optional: find_data_array`に渡される検索フラグ ('i' は大文字小文字無視)。デフォルトは `''。
convert_type -- type or None, optional: データ配列の要素を変換する型 (例: int, float)。デフォルトは None。
def_val -- any, optional: 変換に失敗した場合に使用するデフォルト値。
is_print -- bool, optional: 現在未使用のパラメータ。デフォルトは True。
- 戻り値:
tuple[list[str or None], list[list or None]]: 読み込まれたラベルのリストとデータリストのリストのタプル。