update readme

README.md

@@ -59,7 +59,7 @@ $ pip install event-vision-library
 
 ## Usage
 
-Please see our examples and [documentation][read the docs].
+Please see our [examples] and [documentation][read the docs].
 
 ## Contributing
 
@@ -87,6 +87,7 @@ This project was generated from [Hypermodern Python Cookiecutter] template.
 
 <!-- github-only -->
 
+[examples]: https://github.com/shiba24/event-vision-library/blob/main/examples
 [license]: https://github.com/shiba24/event-vision-library/blob/main/LICENSE
 [contributor guide]: https://github.com/shiba24/event-vision-library/blob/main/CONTRIBUTING.md
 [command-line reference]: https://event-vision-library.readthedocs.io/en/latest/usage.html

examples/convert_text_to_hdf5.py

@@ -0,0 +1,15 @@
+"""Convert existing text format event file into hdf5 file"""
+
+from evlib.codec import fileformat
+
+# Setup iterator reader
+text_file_path = "./artifacts/sample_data/event.txt"
+ev_iter = fileformat.IteratorTextEvent(text_file_path)
+
+# Define key mapping for the hdf5 file
+data_keys = {"x": "raw_events/x", "y": "raw_events/y", "t": "raw_events/t", "p": "raw_events/p"}
+
+# Convert
+output_file_name = "event.hdf5"
+fileformat.convert_iterator_access_to_hdf5(ev_iter, output_file_name, data_keys)
+print(f"Finished conversion: {output_file_name}")