comm.BasebandFileReader
ファイルからのベースバンド信号の読み取り
説明
comm.BasebandFileReader System object™ は、comm.BasebandFileWriter System object により書き込まれた特定のタイプのバイナリ ファイルからベースバンド信号を読み取ります。ベースバンド信号は、通常はゼロでない中心周波数から 0 Hz にダウンコンバートされます。SampleRate プロパティと CenterFrequency プロパティはファイルの作成時に保存されます。comm.BasebandFileReader オブジェクトは、サンプルレート、中心周波数、チャネル数、および任意の記述データを自動的に読み取り、読み取り専用プロパティに保存します。
ファイルからベースバンド ファイルを読み取るには、次のようにします。
comm.BasebandFileReaderオブジェクトを作成し、そのプロパティを設定します。関数と同様に、引数を指定してオブジェクトを呼び出します。
System object の機能の詳細については、System object とはを参照してください。
作成
構文
説明
bbr = comm.BasebandFileReadercomm.BasebandFileWriter System object により書き込まれた特定のタイプのバイナリ ファイルからベースバンド信号を読み取ります。
bbr = comm.BasebandFileReader(fname,spf) はさらに、SamplesPerFrame プロパティを spf に設定します。
bbr = comm.BasebandFileReader(___,Name=Value) は、前述の任意の構文の入力引数の組み合わせに加えて、名前と値の引数を 1 つ以上使用してプロパティを設定します。たとえば、SampleRate=2 は、ベースバンド ファイル リーダーのサンプル レートを 2 に設定します。
プロパティ
オブジェクト関数
オブジェクト関数を使用するには、System object を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、次の構文を使用します。
release(obj)
例
comm.BasebandFileReader System object の 1 回の呼び出しで、ファイルからベースバンド信号を読み取ります。1 回のオブジェクト呼び出しでファイルからすべてのサンプルを読み取るには、フレームあたりのサンプル数を inf に設定するか、データ ファイル内のサンプル数と等しくなるように設定します。
フレームあたりのサンプル数を inf に設定して、baseband file reader オブジェクトを作成します。info オブジェクト関数を使用して、bbr に関する追加情報を取得します。ファイルには 'double' 型のサンプルが 10,000 個含まれています。サンプルはまったく読み取られていません。
bbr1 = comm.BasebandFileReader('baseband_samples_1ghz.bb',SamplesPerFrame=inf)bbr1 =
comm.BasebandFileReader with properties:
Filename: '/tmp/Bdoc25b_2988451_2189139/tpb5173e5a/comm-ex94749964/baseband_samples_1ghz.bb'
SampleRate: 1
CenterFrequency: 100000000
NumChannels: 1
Metadata: [1×1 struct]
SamplesPerFrame: Inf
CyclicRepetition: false
info(bbr1)
ans = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 0
これで、bbr オブジェクトを 1 回呼び出すことで baseband_samples_1ghz.bb ファイルの内容全体が読み取られます。すべてのサンプルが読み取られたことを確認します。
samples1 = bbr1(); info(bbr1)
ans = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 10000
ベースバンド ファイル リーダーのリソースを解放します。
release(bbr1)
代わりに、オブジェクトを 1 回呼び出してファイルからすべてのサンプルを読み取るには、フレームあたりのサンプル数をデータ ファイル内のサンプル数と等しくなるように設定します。これを行うには、フレームあたりのサンプル数の設定 (bbr.SamplesPerFrame) を、オブジェクト関数 info によって返される NumSamplesInData の値に更新しなければなりません。
baseband file reader オブジェクトを作成し、info オブジェクト関数によって返された構造体を表示します。
bbr2 = comm.BasebandFileReader('baseband_samples_1ghz.bb')bbr2 =
comm.BasebandFileReader with properties:
Filename: '/tmp/Bdoc25b_2988451_2189139/tpb5173e5a/comm-ex94749964/baseband_samples_1ghz.bb'
SampleRate: 1
CenterFrequency: 100000000
NumChannels: 1
Metadata: [1×1 struct]
SamplesPerFrame: 100
CyclicRepetition: false
bbrinfo = info(bbr2)
bbrinfo = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 0
bbr2.SamplesPerFrame = bbrinfo.NumSamplesInData
bbr2 =
comm.BasebandFileReader with properties:
Filename: '/tmp/Bdoc25b_2988451_2189139/tpb5173e5a/comm-ex94749964/baseband_samples_1ghz.bb'
SampleRate: 1
CenterFrequency: 100000000
NumChannels: 1
Metadata: [1×1 struct]
SamplesPerFrame: 10000
CyclicRepetition: false
これで、bbr オブジェクトを 1 回呼び出すことで baseband_samples_1ghz.bb ファイルの内容全体が読み取られます。すべてのサンプルが読み取られたことを確認し、bbr1 と bbr2 によって読み取られたサンプルを比較します。
samples2 = bbr2(); info(bbr2)
ans = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 10000
isequal(samples1,samples2)
ans = logical
1
ベースバンド ファイル リーダーのリソースを解放します。
release(bbr2)
ベースバンド ファイル リーダー System object™ の呼び出しを複数回使用して、ファイルからベースバンド信号を読み取ります。
baseband file reader オブジェクトを作成します。
bbr = comm.BasebandFileReader('baseband_samples_1ghz.bb')bbr =
comm.BasebandFileReader with properties:
Filename: '/tmp/Bdoc25b_2988451_2189139/tpb5173e5a/comm-ex87872352/baseband_samples_1ghz.bb'
SampleRate: 1
CenterFrequency: 100000000
NumChannels: 1
Metadata: [1×1 struct]
SamplesPerFrame: 100
CyclicRepetition: false
オブジェクト関数 info を使用して、ベースバンド ファイル リーダーに関する追加情報を取得します。ファイルにはデータ型 double のサンプルが 10,000 個含まれています。サンプルはまったく読み取られていません。
info(bbr)
ans = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 0
ベースバンド ファイル (baseband_samples_1ghz.bb) にはサンプルが 10,000 個含まれています。baseband file reader オブジェクトのフレームあたりのサンプル数が 100 に設定されているため、ベースバンド ファイルの内容全体を読み取るには、オブジェクトを複数回呼び出す必要があります。ファイルからすべてのサンプルを読み取るには、オブジェクト関数 isDone を使用して while ループを終了します。
y = []; while ~isDone(bbr) x = bbr(); y = cat(1,y,x); end
info オブジェクト関数を使用して、すべてのサンプルがファイルから読み取られたことを確認します。サンプルの合計数と読み取られたサンプル数は同じです。
info(bbr)
ans = struct with fields:
NumSamplesInData: 10000
DataType: 'double'
NumSamplesRead: 10000
ベースバンド データの絶対値の振幅をプロットします。
plot(abs(y)) title('Baseband Signal Read From File') xlabel('Samples') ylabel('Amplitude')
ベースバンド ファイル リーダーのリソースを解放します。
release(bbr)
