TSDuck v3.46-4965
MPEG Transport Stream Toolkit
Loading...
Searching...
No Matches

#include <tsTSAnalyzer.h>

Inheritance diagram for ts::TSAnalyzer:
Collaboration diagram for ts::TSAnalyzer:

Classes

class  PIDContext
class  ServiceContext
class  XTIDContext

Public Member Functions

 TSAnalyzer (DuckContext &duck, const BitRate &bitrate_hint=0, BitRateConfidence bitrate_confidence=BitRateConfidence::LOW)
virtual ~TSAnalyzer () override
void feedPacket (const TSPacket &packet, const TSPacketMetadata &mdata)
void getGlobalPIDs (std::vector< PID > &list)
void getPIDs (std::vector< PID > &list)
void getPIDsOfService (std::vector< PID > &list, uint16_t service_id)
void getPIDsWithPES (std::vector< PID > &list)
void getServiceIds (std::vector< uint16_t > &list)
void getUnreferencedPIDs (std::vector< PID > &list)
void reset ()
void setBitrateHint (const BitRate &bitrate_hint=0, BitRateConfidence bitrate_confidence=BitRateConfidence::LOW)
void setMaxConsecutiveSuspectCount (uint64_t count)
void setMinErrorCountBeforeSuspect (uint64_t count)

Protected Types

using PIDContextMap = std::map<PID, PIDContextPtr>
using PIDContextPtr = std::shared_ptr<PIDContext>
using ServiceContextMap = std::map<uint16_t, ServiceContextPtr>
using ServiceContextPtr = std::shared_ptr<ServiceContext>
using ServiceIdSet = std::set<uint16_t>
using XTIDContextMap = std::map<XTID, XTIDContextPtr>
using XTIDContextPtr = std::shared_ptr<XTIDContext>

Protected Member Functions

PIDContextPtr getPID (PID pid, const UString &description=UNREFERENCED)
ServiceContextPtr getService (uint16_t service_id)
XTIDContextPtr getXTID (const Section &section)
bool pidExists (PID pid) const
void recomputeStatistics ()

Protected Attributes

UString _country_code {}
 TOT country code.
DuckContext & _duck
 TSDuck execution context.
cn::milliseconds _duration {}
 Total broadcast duration.
Time _first_local {}
 First system local time (first packet).
Time _first_stt {}
 First STT (ATCS) UTC time stamp.
Time _first_tdt {}
 First TDT UTC time stamp.
Time _first_tot {}
 First TOT local time stamp.
Time _first_utc {}
 First system UTC time (first packet).
BitRate _global_bitrate = 0
 Bitrate for global PID's.
ISDBTLayerCounter _global_isdb_layers {}
 Same as _isdb_layers for global PID's.
size_t _global_pid_cnt = 0
 Number of global PID's (ref but no service).
uint64_t _global_pkt_cnt = 0
 Number of packets in global PID's.
size_t _global_scr_pids = 0
 Number of scrambled global PID's.
uint64_t _invalid_sync = 0
 Number of packets with invalid sync byte (not 0x47).
Time _last_local {}
 Last system local time (recomputeStatistics).
Time _last_stt {}
 Last STT (ATCS) time stamp.
Time _last_tdt {}
 Last TDT UTC time stamp.
Time _last_tot {}
 Last TOT local time stamp.
Time _last_utc {}
 Last system UTC time (recomputeStatistics).
size_t _pcr_pid_cnt = 0
 Number of PID's with PCR's.
size_t _pid_cnt = 0
 Number of PID's (with actual packets).
PIDContextMap _pids {}
 Description of PIDs.
BitRate _psisi_bitrate = 0
 Bitrate for global PSI/SI PID's.
size_t _psisi_pid_cnt = 0
 Number of global PSI/SI PID's (0x00 to 0x1F).
uint64_t _psisi_pkt_cnt = 0
 Number of packets in global PSI/SI PID's.
size_t _psisi_scr_pids = 0
 Number of scrambled global PSI/SI PID's (normally zero).
size_t _scrambled_pid_cnt = 0
 Number of scrambled PID's.
uint16_t _scrambled_services_cnt = 0
 Number of scrambled services.
ServiceContextMap _services {}
 Description of services, map key: service id.
uint64_t _suspect_ignored = 0
 Number of suspect packets, ignored.
std::bitset< TID_MAX > _tid_present {}
 Array of detected tables.
uint64_t _transport_errors = 0
 Number of packets with transport error.
BitRate _ts_bitrate = 0
 TS bitrate (either from PCR or options).
std::optional< uint16_t > _ts_id {}
 Transport stream id.
ISDBTLayerCounter _ts_isdb_layers {}
 For ISDB-T streams with 204-byte packets, map key = layer indicator (0-1) to value = number of TS packets.
BitRate _ts_pcr_bitrate_188 = 0
 Average TS bitrate in b/s (eval from PCR).
BitRate _ts_pcr_bitrate_204 = 0
 Average TS bitrate in b/s (eval from PCR).
uint64_t _ts_pkt_cnt = 0
 Number of TS packets.
BitRate _ts_user_bitrate = 0
 User-specified TS bitrate (if any).
BitRateConfidence _ts_user_br_confidence = BitRateConfidence::LOW
 Confidence in user-specified TS bitrate.
BitRate _unref_bitrate = 0
 Bitrate for unreferenced PID's.
ISDBTLayerCounter _unref_isdb_layers {}
 Same as _isdb_layers for unreferenced PID's.
size_t _unref_pid_cnt = 0
 Number of unreferenced PID's.
uint64_t _unref_pkt_cnt = 0
 Number of packets in unreferenced PID's.
size_t _unref_scr_pids = 0
 Number of scrambled unreferenced PID's.

Detailed Description

A class which analyzes a complete transport stream.

Member Typedef Documentation

◆ ServiceContextPtr

using ts::TSAnalyzer::ServiceContextPtr = std::shared_ptr<ServiceContext>
protected

Safe pointer to a ServiceContext (not thread-safe).

◆ ServiceContextMap

using ts::TSAnalyzer::ServiceContextMap = std::map<uint16_t, ServiceContextPtr>
protected

Map of ServiceContext, indexed by service id.

◆ ServiceIdSet

using ts::TSAnalyzer::ServiceIdSet = std::set<uint16_t>
protected

Set of service ids.

◆ XTIDContextPtr

using ts::TSAnalyzer::XTIDContextPtr = std::shared_ptr<XTIDContext>
protected

Safe pointer to an XTIDContext (not thread-safe).

◆ XTIDContextMap

using ts::TSAnalyzer::XTIDContextMap = std::map<XTID, XTIDContextPtr>
protected

Map of XTIDContext, indexed by XTID.

◆ PIDContextPtr

using ts::TSAnalyzer::PIDContextPtr = std::shared_ptr<PIDContext>
protected

Safe pointer to a PIDContext (not thread-safe).

◆ PIDContextMap

using ts::TSAnalyzer::PIDContextMap = std::map<PID, PIDContextPtr>
protected

Map of PIDContext, indexed by PID.

Constructor & Destructor Documentation

◆ TSAnalyzer()

ts::TSAnalyzer::TSAnalyzer ( DuckContext & duck,
const BitRate & bitrate_hint = 0,
BitRateConfidence bitrate_confidence = BitRateConfidence::LOW )
explicit

Default constructor.

Parameters
[in,out]duckTSDuck execution context. The reference is kept inside the analyzer.
[in]bitrate_hintOptional bitrate "hint" for the analysis. It is the user-specified bitrate in bits/seconds, based on 188-byte packets. The bitrate hint is optional: if specified as zero, the analysis is based on the PCR values.
[in]bitrate_confidenceConfidence level in bitrate_hint.

◆ ~TSAnalyzer()

virtual ts::TSAnalyzer::~TSAnalyzer ( )
overridevirtual

Destructor.

Member Function Documentation

◆ feedPacket()

void ts::TSAnalyzer::feedPacket ( const TSPacket & packet,
const TSPacketMetadata & mdata )

The following method feeds the analyzer with a TS packet. The stream is analyzed by repeatedly calling feedPacket().

Parameters
[in]packetOne TS packet from the stream.
[in]mdataAssociated metadata.

◆ reset()

void ts::TSAnalyzer::reset ( )

Reset the analysis context.

◆ setBitrateHint()

void ts::TSAnalyzer::setBitrateHint ( const BitRate & bitrate_hint = 0,
BitRateConfidence bitrate_confidence = BitRateConfidence::LOW )

Specify a "bitrate hint" for the analysis.

Parameters
[in]bitrate_hintOptional bitrate "hint" for the analysis. It is the user-specified bitrate in bits/seconds, based on 188-byte packets. The bitrate hint is optional: if specified as zero, the analysis is based on the PCR values.
[in]bitrate_confidenceConfidence level in bitrate_hint.

◆ setMinErrorCountBeforeSuspect()

void ts::TSAnalyzer::setMinErrorCountBeforeSuspect ( uint64_t count)
inline

Set the number of consecutive packet errors threshold.

Parameters
[in]countThe number of consecutive packet errors after which a packet is considered as suspect if it does not belong to a previously known PID. If set to zero, suspect packet detection is disabled. Initially set to the default value 1.

◆ setMaxConsecutiveSuspectCount()

void ts::TSAnalyzer::setMaxConsecutiveSuspectCount ( uint64_t count)
inline

Set the maximum number of consecutive suspect packets.

Parameters
[in]countWhen that number of consecutive suspect packets is reached, the next packet will not be considered for suspect detection. Initially set to the default value 1.

◆ getServiceIds()

void ts::TSAnalyzer::getServiceIds ( std::vector< uint16_t > & list)

Get the list of service ids.

Parameters
[out]listThe returned list of service ids.

◆ getPIDs()

void ts::TSAnalyzer::getPIDs ( std::vector< PID > & list)

Get the list of all PID's.

Parameters
[out]listThe returned list of all PID's.

◆ getGlobalPIDs()

void ts::TSAnalyzer::getGlobalPIDs ( std::vector< PID > & list)

Get the list of global PID's. Global PID's are PID's which do not belong to a service.

Parameters
[out]listThe returned list of global PID's.

◆ getUnreferencedPIDs()

void ts::TSAnalyzer::getUnreferencedPIDs ( std::vector< PID > & list)

Get the list of unreferenced PID's.

Parameters
[out]listThe returned list of unreferenced PID's.

◆ getPIDsOfService()

void ts::TSAnalyzer::getPIDsOfService ( std::vector< PID > & list,
uint16_t service_id )

Get the list of PID's for one service id.

Parameters
[out]listThe returned list of PID's.
[in]service_idThe service id.

◆ getPIDsWithPES()

void ts::TSAnalyzer::getPIDsWithPES ( std::vector< PID > & list)

Get the list of PID's carrying PES packets.

Parameters
[out]listThe returned list of PID's carrying PES packets.

◆ getService()

ServiceContextPtr ts::TSAnalyzer::getService ( uint16_t service_id)
protected

Get a service context. Allocate a new entry if service is not found.

Parameters
[in]service_idService to search.
Returns
A safe pointer to the service context.

◆ getXTID()

XTIDContextPtr ts::TSAnalyzer::getXTID ( const Section & section)
protected

Get an XTID context. Allocate a new entry if the XTID is not found.

Parameters
[in]sectionA section containing the XTID to search.
Returns
A safe pointer to the XTID context.

◆ pidExists()

bool ts::TSAnalyzer::pidExists ( PID pid) const
inlineprotected

Check if a PID context exists.

Parameters
[in]pidPID to search.
Returns
True if the PID exists, false otherwise.

◆ getPID()

PIDContextPtr ts::TSAnalyzer::getPID ( PID pid,
const UString & description = UNREFERENCED )
protected

Get a PID context. Allocate a new entry if PID not found.

Parameters
[in]pidPID to search.
[in]descriptionInitial description of the PID if the context is created.
Returns
A safe pointer to the PID context.

◆ recomputeStatistics()

void ts::TSAnalyzer::recomputeStatistics ( )
protected

Update the global statistics value if internal data were modified.


The documentation for this class was generated from the following file: