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

Add initial docs #37

Merged
merged 20 commits into from
Mar 8, 2021
Merged

Add initial docs #37

merged 20 commits into from
Mar 8, 2021

Conversation

bencottier
Copy link
Contributor

@bencottier bencottier commented Mar 1, 2021

Closes #36

Includes pages for an introduction, the API, overview of how Transforms work, and a longer example.

Note the built docs can be previewed by clicking the "details" link next to the documenter/deploy check.

@codecov
Copy link

codecov bot commented Mar 1, 2021

Codecov Report

Merging #37 (0683c76) into main (7aef385) will decrease coverage by 0.71%.
The diff coverage is 100.00%.

Impacted file tree graph

@@            Coverage Diff             @@
##             main      #37      +/-   ##
==========================================
- Coverage   95.31%   94.59%   -0.72%     
==========================================
  Files           9        9              
  Lines         128      111      -17     
==========================================
- Hits          122      105      -17     
  Misses          6        6              
Impacted Files Coverage Δ
src/power.jl 100.00% <100.00%> (ø)
src/transformers.jl 100.00% <100.00%> (ø)
src/scaling.jl 96.15% <0.00%> (-0.52%) ⬇️
src/periodic.jl 100.00% <0.00%> (ø)
src/one_hot_encoding.jl 100.00% <0.00%> (ø)
src/linear_combination.jl 100.00% <0.00%> (ø)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7aef385...ab0ac98. Read the comment docs.

@bencottier bencottier requested a review from glennmoy March 2, 2021 10:23
docs/make.jl Outdated Show resolved Hide resolved
docs/src/examples.md Outdated Show resolved Hide resolved
docs/src/examples.md Outdated Show resolved Hide resolved
docs/src/examples.md Outdated Show resolved Hide resolved
docs/src/examples.md Show resolved Hide resolved
docs/src/index.md Outdated Show resolved Hide resolved
docs/src/index.md Outdated Show resolved Hide resolved
docs/src/transforms.md Outdated Show resolved Hide resolved
docs/src/transforms.md Outdated Show resolved Hide resolved
docs/src/transforms.md Show resolved Hide resolved
Copy link
Member

@morris25 morris25 left a comment

Choose a reason for hiding this comment

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

LGTM

Without specifying optional arguments, a `Transform` is applied to every element of an `AbstractArray` and in an element-wise fashion:

```jldoctest transforms
julia> M = [2 4; 1 5; 3 6];
Copy link
Member

Choose a reason for hiding this comment

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

You might want to change this to a float array to avoid failing the 32 bit tests

docs/src/transforms.md Show resolved Hide resolved
Comment on lines 80 to 82
Some `Transform` subtypes have restrictions on how they can be applied once constructed.
For instance, `MeanStdScaling` stores the mean and standard deviation of some data for specified dimensions or column names.
So `MeanStdScaling` should only be applied to the same data type and for the same dimensions or subset of column names specified in construction.
Copy link
Member

@glennmoy glennmoy Mar 5, 2021

Choose a reason for hiding this comment

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

I'll address this (and any other things that conflict) when I finish #42

docs/src/transforms.md Outdated Show resolved Hide resolved
docs/src/transforms.md Outdated Show resolved Hide resolved
docs/src/transforms.md Outdated Show resolved Hide resolved
docs/src/transforms.md Show resolved Hide resolved
docs/src/examples.md Outdated Show resolved Hide resolved
@bencottier bencottier merged commit fbc7b8f into main Mar 8, 2021
@bencottier bencottier deleted the bc/docs-initial branch March 8, 2021 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add initial docs
3 participants