Skip to content

Commit

Permalink
update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
PetrKryslUCSD committed Feb 25, 2024
1 parent 9feab31 commit b8e9b6f
Show file tree
Hide file tree
Showing 9 changed files with 385 additions and 424 deletions.
337 changes: 199 additions & 138 deletions docs/Manifest.toml

Large diffs are not rendered by default.

3 changes: 2 additions & 1 deletion docs/make.jl
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,14 @@ using Documenter, FinEtoolsFlexStructures
makedocs(
modules = [FinEtoolsFlexStructures],
doctest = false, clean = true,
warnonly = Documenter.except(:linkcheck, :footnote),
format = Documenter.HTML(prettyurls = false),
authors = "Petr Krysl",
sitename = "FinEtoolsFlexStructures.jl",
pages = Any[
"Home" => "index.md",
"How to guide" => "guide/guide.md",
"Reference" => "man/reference.md"
"Reference" => "man/man.md"
],
)

Expand Down
10 changes: 6 additions & 4 deletions docs/src/guide/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,13 @@ The basic functionality is provided by the [`FinEtools`]
(https://github.com/PetrKryslUCSD/FinEtools.jl)
package.

To understand how the package works, we would suggest inspecting the examples.

Tutorials are provided in the form of Julia scripts and Markdown files in a dedicated folder: [`index of tutorials`](https://github.com/PetrKryslUCSD/FinEtoolsFlexStructures.jl/blob/main/tutorials/index.md).



To understand how the package works in depth, we would suggest inspecting the examples.
The examples are organized by category: statics, dynamics, etc. There is
usually an indication of what the correct answer should be
(frequencies, deflections, buckling factors, ...). Many examples correspond to
well-known benchmarks.



21 changes: 18 additions & 3 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,32 @@
# FinEtoolsFlexStructures Documentation


The [tutorials](https://github.com/PetrKryslUCSD/FinEtoolsFlexStructuresTutorials.jl) are provided in the form of Julia scripts and Markdown files in a separate [package](https://github.com/PetrKryslUCSD/FinEtoolsFlexStructuresTutorials.jl).
```@contents
```

## Conceptual guide

The construction of the toolkit is described: the composition of modules, the basic data structures, the methodology of computing quantities required in the finite element methodology, and more.

```@contents
Pages = [
"guide/guide.md",
]
Depth = 1
```

## Manual

The description of the types and the functions, organized by module and/or other logical principle.

```@contents
Pages = [
"man/types.md",
"man/functions.md",
"man/man.md",
]
Depth = 2
```

## Index

```@index
```
133 changes: 0 additions & 133 deletions docs/src/man/functions.md

This file was deleted.

150 changes: 150 additions & 0 deletions docs/src/man/man.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,150 @@
# Manual


```@meta
CurrentModule = FinEtoolsFlexStructures
```


## Composite Layup

```@autodocs
Modules = [FinEtoolsFlexStructures.CompositeLayupModule]
Private = true
Order = [:function, :type]
```

## Cross Section

```@autodocs
Modules = [FinEtoolsFlexStructures.CrossSectionModule]
Private = true
Order = [:function, :type]
```

## Meshing of Frame Members

```@autodocs
Modules = [FinEtoolsFlexStructures.MeshFrameMemberModule]
Private = true
Order = [:function, :type]
```

## FE Set for two-node Beams

```@autodocs
Modules = [FinEtoolsFlexStructures.FESetL2BeamModule]
Private = true
Order = [:function, :type]
```

## FE Set for Shell T3 shapes

```@autodocs
Modules = [FinEtoolsFlexStructures.FESetShellT3Module]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for Corotational Beams

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMCorotBeamModule]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for linear beams with eccentric connections

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMLinBeamModule]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for reduced-integration Timoshenko beams

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMRITBeamModule]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for Shell T3FF with homogeneous composition

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMShellT3FFModule]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for Shell T3FF with layered composition

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMShellT3FFCompModule]
Private = true
Order = [:function, :type, :constant]
```

## FEMM for point masses

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMPointMassModule]
Private = true
Order = [:function, :type]
```

## FEMM for Grounded springs

```@autodocs
Modules = [FinEtoolsFlexStructures.FEMMPointGroundedSpringModule]
Private = true
Order = [:function, :type]
```

## Rotation utilities

```@autodocs
Modules = [FinEtoolsFlexStructures.RotUtilModule]
Private = true
Order = [:function, :type]
```

## Transformer functions

```@autodocs
Modules = [FinEtoolsFlexStructures.TransformerModule]
Private = true
Order = [:function, :type]
```

## Assembly of special matrices

```@autodocs
Modules = [FinEtoolsFlexStructures.AssemblyModule]
Private = true
Order = [:function, :type]
```

## Modules

```@docs
FinEtoolsFlexStructures.FinEtoolsFlexStructures
FinEtoolsFlexStructures.CompositeLayupModule
FinEtoolsFlexStructures.CrossSectionModule
FinEtoolsFlexStructures.MeshFrameMemberModule
FinEtoolsFlexStructures.FESetL2BeamModule
FinEtoolsFlexStructures.FESetShellT3Module
FinEtoolsFlexStructures.FESetShellQ4Module
FinEtoolsFlexStructures.FEMMCorotBeamModule
FinEtoolsFlexStructures.FEMMLinBeamModule
FinEtoolsFlexStructures.FEMMRITBeamModule
FinEtoolsFlexStructures.FEMMShellT3FFModule
FinEtoolsFlexStructures.FEMMShellT3FFCompModule
FinEtoolsFlexStructures.FEMMPointMassModule
FinEtoolsFlexStructures.FEMMPointGroundedSpringModule
FinEtoolsFlexStructures.RotUtilModule
FinEtoolsFlexStructures.TransformerModule
FinEtoolsFlexStructures.AssemblyModule
```

7 changes: 0 additions & 7 deletions docs/src/man/reference.md

This file was deleted.

Loading

2 comments on commit b8e9b6f

@PetrKryslUCSD
Copy link
Owner Author

Choose a reason for hiding this comment

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

@JuliaRegistrator
Copy link

Choose a reason for hiding this comment

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

Registration pull request created: JuliaRegistries/General/101640

Tip: Release Notes

Did you know you can add release notes too? Just add markdown formatted text underneath the comment after the text
"Release notes:" and it will be added to the registry PR, and if TagBot is installed it will also be added to the
release that TagBot creates. i.e.

@JuliaRegistrator register

Release notes:

## Breaking changes

- blah

To add them here just re-invoke and the PR will be updated.

Tagging

After the above pull request is merged, it is recommended that a tag is created on this repository for the registered package version.

This will be done automatically if the Julia TagBot GitHub Action is installed, or can be done manually through the github interface, or via:

git tag -a v3.0.0 -m "<description of version>" b8e9b6f7ad1f5bb8514bfbb687c6d0cec8a13af1
git push origin v3.0.0

Please sign in to comment.