Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1689)

Unified Diff: tools/py_event_log_analyzer/README

Issue 1999113002: New rtc dump analyzing tool in Python (Closed) Base URL: https://chromium.googlesource.com/external/webrtc.git@master
Patch Set: Moved unit test. Created 4 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | tools/py_event_log_analyzer/misc.py » ('j') | tools/py_event_log_analyzer/misc.py » ('J')
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: tools/py_event_log_analyzer/README
diff --git a/tools/py_event_log_analyzer/README b/tools/py_event_log_analyzer/README
new file mode 100644
index 0000000000000000000000000000000000000000..7d30999731142a763221c2f51a90495c897eec39
--- /dev/null
+++ b/tools/py_event_log_analyzer/README
@@ -0,0 +1,35 @@
+This file describes how to set up and use the RTP log analyzer.
+
+Run the tool as follows:
+
+ python rtp_analyzer.py <rtc event log>
+
+where <rtc event log> is a recorded RTC event log, which is stored in
+protobuf format. Such logs are generated in multiple ways, e.g. by
+Chrome through the chrome://webrtc-internals page.
+
+The script has been tested to work in python versions 3.4.1 and 2.7.6,
+but should work in all python versions for which there is a version
+of the dependencies.
+
+Dependencies
+------------
+
+The analyzer script needs *numpy* (http://www.numpy.org/) and
+*matplotlib* (http://matplotlib.org/).
+
+A version of Protocol Buffers is needed as well. One is distributed
+along with WebRTC in `thirdparty/protobuf/python`. This tool also
+needs a file `rtc_event_log_pb2.py` which is automatically generated
+from `webrtc/call/rtc_event_log.proto` and placed in
+`out/<TARGET>/pyproto/webrtc/call/` with every WebRTC compilation. To
+use it, WebRTC needs to be compiled before using this tool.
+
+An alternative to compiling WebRTC is to install your own version of
+Protocol Buffers and `protoc`, the Protocol Buffer compiler.
+
+If you use your own version of protobuf, generate the python file in
+this folder with
+
+ protoc -I $WEBRTC_ROOT/webrtc/call $WEBRTC_ROOT/webrtc/call/rtc_event_log.proto --python_out ./
+
« no previous file with comments | « no previous file | tools/py_event_log_analyzer/misc.py » ('j') | tools/py_event_log_analyzer/misc.py » ('J')

Powered by Google App Engine
This is Rietveld 408576698