Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Getting started #143

Merged
merged 7 commits into from
Jun 12, 2023
Merged

Getting started #143

merged 7 commits into from
Jun 12, 2023

Conversation

DonBraulio
Copy link
Collaborator

This PR promotes the toy_example.ipynb -> getting_started.ipynb after some improvements to it:

  • Added general explanations.
  • Added links to resources in the documentation (Next steps section)
  • Added graph definition explanations and more examples.
  • Cover basic index manipulation example.

I'm also proposing to link it from the README, with a couple more changes there. Further discussion about those is expected and welcome 🙂

Note: This should be merged after #141 , since it introduces some changes to the toy_example notebook.

@DonBraulio DonBraulio added the documentation Improvements or additions to documentation label May 31, 2023
@DonBraulio DonBraulio self-assigned this May 31, 2023
README.md Outdated
@@ -36,19 +34,26 @@ sma = tp.simple_moving_average(node, window_length=tp.days(7))
result = sma.evaluate(evset)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about adding a print and plot?

tp.read_event_set("path/to/temporal_data.csv", timestamp_column="time")
What about showing / describing what the csv file contains. Alternatively, what about creating an example by hand.

README.md Outdated
@@ -36,19 +34,26 @@ sma = tp.simple_moving_average(node, window_length=tp.days(7))
result = sma.evaluate(evset)
```

Check the [Getting Started tutorial](examples/tutorials/getting_started.ipynb) to try it!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this point to the website or github?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, this one should point to the docs website, definitely

@ianspektor
Copy link
Collaborator

Should this folder be ignored?

image

README.md Outdated Show resolved Hide resolved
## Key features

These are what set Temporian apart.

- **Simple and powerful API**: Temporian exports high level operations making processing complex programs short and ready to read.
- **Flexible data model**: Temporian models temporal data as a sequence of events, supporting non-uniform sampling timestamps seamlessly.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice

README.md Outdated
- **Prevents modeling errors**: Temporian programs are guaranteed not to have future leakage unless the user calls the `leak` function, ensuring that models are not trained on future data.
- **Iterative development**: Temporian can be used to develop preprocessing pipelines in Colab or local notebooks, allowing users to visualize results each step of the way to identify and correct errors early on.
- **Efficient and well-tested implementations**: Temporian contains efficient and well-tested implementations of a variety of temporal data processing functions. For instance, our implementation of window operators is **x2000** faster than the same function implemented with NumPy.
- **Wide range of preprocessing functions**: Temporian contains a wide range of preprocessing functions, including moving window operations, lagging, calendar features, arithmetic operations, index manipulation and propagation, resampling, and more. For a full list of the available operators, see the [operators documentation](https://temporian.readthedocs.io/en/latest/reference/temporian/core/operators/).

## Documentation
## Why Temporian?
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd kill this section, especially since the M5 notebook isn't really readable atm

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree. Removed 😬

README.md Outdated Show resolved Hide resolved
@DonBraulio
Copy link
Collaborator Author

Should this folder be ignored?

It's already ignored via tmp_* in gitignore.

@DonBraulio
Copy link
Collaborator Author

README fixed and comments addressed. Make sure to force refresh on the docs preview to see the changes.

@DonBraulio DonBraulio merged commit 10be392 into main Jun 12, 2023
@DonBraulio DonBraulio deleted the notebooks-improvements branch June 12, 2023 14:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants