-
Notifications
You must be signed in to change notification settings - Fork 3
/
learn.qmd
119 lines (71 loc) · 4.66 KB
/
learn.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
---
title: "Learn"
toc: true
---
> Resources to help get started.
## Installation
After installing Julia from the official website, head to the [Packages](packages.qmd) to see how to install JuliaActuary packages.
## Documentation
Each [package](packages.qmd) includes examples on the Github site and in the documentation.
## Introductory Programming and Julia Resources
- [JuliaLang.org](https://julialang.org/), the home site with the downloads to get started, and links to learning resources.
- [JuliaHub](https://juliahub.com/ui/Home) indexes open-source Julia packages and makes the entire ecosystem and documentation searchable from one place.
- [JuliaAcademy](https://juliaacademy.com/courses), which has free short courses in Data Science, Introduction to Julia, DataFrames.jl, Machine Learning, and more.
- [Data Science Tutorials](https://alan-turing-institute.github.io/DataScienceTutorials.jl/) from the Alan Turing Institute.
- [Learn Julia in Y minutes](https://learnxinyminutes.com/docs/julia/), a great quick-start if you are already comfortable with coding.
- [Think Julia](https://benlauwens.github.io/ThinkJulia.jl/latest/book.html), a free e-book (or paid print edition) book which introduces programming from the start and teaches you valuable ways of thinking.
- [Design Patterns and Best Practices](https://www.packtpub.com/application-development/hands-design-patterns-julia-10), a book that will help you as you transition from smaller, one-off scripts to designing larger packages and projects.
## Example Actuarial and Finance Uses
See the [examples page](/examples.qmd).
## Get Help
> Ask questions or suggest ideas
### Discussion and Questions
If you have other ideas or questions, join the [JuliaActuary Github Discussions](https://github.com/orgs/JuliaActuary/discussions). Or come say hello on the community [Zulip](https://julialang.zulipchat.com/#narrow/stream/249536-actuary) or [Slack #actuary channel](https://julialang.org/slack/). We welcome all actuarial and related disciplines!
### Help mode
You can also access help text when using the packages in the REPL by [activating help mode](https://docs.julialang.org/en/v1/stdlib/REPL/index.html#Help-mode-1), e.g.:
```julia-repl
julia> ? survival
survival(mortality_vector,to_age)
survival(mortality_vector,from_age,to_age)
Returns the survival through attained age to_age. The start of the
calculation is either the start of the vector, or attained age `from_age`
and `to_age` need to be Integers.
Add a DeathDistribution as the last argument to handle floating point
and non-whole ages:
survival(mortality_vector,to_age,::DeathDistribution)
survival(mortality_vector,from_age,to_age,::DeathDistribution)
If given a negative to_age, it will return 1.0. Aside from simplifying the code,
this makes sense as for something to exist in order to decrement in the first place,
it must have existed and survived to the point of being able to be decremented.
Examples
≡≡≡≡≡≡≡≡≡≡
julia> qs = UltimateMortality([0.1,0.3,0.6,1]);
julia> survival(qs,0)
1.0
julia> survival(qs,1)
0.9
julia> survival(qs,1,1)
1.0
julia> survival(qs,1,2)
0.7
julia> survival(qs,0.5,Uniform())
0.95
```
## Integration with R and Python
> Use other languages seamlessly
Julia integrates with other languages, allowing you to leverage existing scripts and packages in R via [RCall](https://github.com/JuliaInterop/RCall.jl) and in Python via [PyCall](https://github.com/JuliaPy/PyCall.jl).
## Contributing
> Contribute code or report issues.
~~~
<mark>Thank you</mark> for your interest in modern actuarial solutions, no matter how you participate in the community.</p>
~~~
### Pull Requests
JuliaActuary is open source; you are free to modify, use, or change your copy of the code - but if you make enhancements please consider opening a pull request ([basic walkthrough here](https://kshyatt.github.io/post/firstjuliapr/)). Beginners are welcome and we can help with your first pull request!
### Issues
If you find issues, please open an issue on the relevant package's repository and we will try and address it as soon as possible.
### Project Board
See the [Good first Issues](https://github.com/orgs/JuliaActuary/projects/2) project board on Github for simple, self-contained ways to contribute such as adding small new features, improving the documentation, or writing up a tutorial on how to do something simple!
## Other Inquiries
For more directed inquires, please send email to [[email protected]](mailto:[email protected]).
## Share
Follow [JuliaActuary](https://www.linkedin.com/company/juliaactuary) on LinkedIn for updates and to share with colleagues!