Watts-Lab / team-process-map

MIT License
0 stars 4 forks source link

Create Separate `examples/` Folder #208

Open xehu opened 2 months ago

xehu commented 2 months ago

Currently, featurize.py (https://github.com/Watts-Lab/team-process-map/blob/main/feature_engine/featurize.py) serves as a "catch-all script" that both functions to test the code and functions as an example constructor. We should separate these two functionalities, and create a separate examples/ folder or repository that achieves the following:

  1. Highlights the featurizer's functionality. The example repository should contain some scripts or iPython notebooks that illustrate how a user can install the package and get started. There should be a sample dataset that they can play with (similar to how R has example datasets such as cars and iris), and the scripts should illustrate how one can instantiate a Featurizer and generate features for a conversation.
  2. Document design decisions and user options. In addition to showcasing basic functions, the examples should also highlight more advanced features, such as the ability to customize which features are desired (https://github.com/Watts-Lab/team-process-map/issues/202), preprocessing (https://github.com/Watts-Lab/team-process-map/issues/204), the vectors (https://github.com/Watts-Lab/team-process-map/issues/205), or the methods of aggregation (https://github.com/Watts-Lab/team-process-map/issues/206).