Skip to content

Commit

Permalink
Merge pull request #4 from Schmiluk/main
Browse files Browse the repository at this point in the history
Sigma.NET Documentation and Tests
  • Loading branch information
LibraChris authored Oct 7, 2024
2 parents fcd909e + b53ea7f commit 5dd1518
Show file tree
Hide file tree
Showing 117 changed files with 26,416 additions and 13,911 deletions.
18 changes: 18 additions & 0 deletions .config/dotnet-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"version": 1,
"isRoot": true,
"tools": {
"fsdocs-tool": {
"version": "20.0.1",
"commands": [
"fsdocs"
]
},
"dotnet-repl": {
"version": "0.1.216",
"commands": [
"dotnet-repl"
]
}
}
}
1 change: 1 addition & 0 deletions .fsdocs/cache

Large diffs are not rendered by default.

5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -396,3 +396,8 @@ FodyWeavers.xsd

# JetBrains Rider
*.sln.iml
*.DS_Store

# Remove temp files
*.tmp
tmp/
9 changes: 9 additions & 0 deletions Sigma.NET.sln
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@ Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Sigma.NET.Interactive", "sr
EndProject
Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Sigma.NET", "src\Sigma.NET\Sigma.NET.fsproj", "{E03988A2-D228-4F6A-A699-8E726762ACFA}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{92979E59-18CC-403E-B4F7-BE7433DE47F2}"
EndProject
Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Sigma.NET.Tests", "tests\Sigma.NET.Tests\Sigma.NET.Tests.fsproj", "{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Expand All @@ -33,6 +37,10 @@ Global
{E03988A2-D228-4F6A-A699-8E726762ACFA}.Debug|Any CPU.Build.0 = Debug|Any CPU
{E03988A2-D228-4F6A-A699-8E726762ACFA}.Release|Any CPU.ActiveCfg = Release|Any CPU
{E03988A2-D228-4F6A-A699-8E726762ACFA}.Release|Any CPU.Build.0 = Release|Any CPU
{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2}.Debug|Any CPU.Build.0 = Debug|Any CPU
{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2}.Release|Any CPU.ActiveCfg = Release|Any CPU
{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
Expand All @@ -41,6 +49,7 @@ Global
{56AC32A3-7D50-4128-A900-F24D9F83944F} = {6CE2AB90-370D-437D-B98D-A3618DBA64F6}
{80BAC37E-6F47-4BD0-849A-D40F2A42EC41} = {865FECD4-7975-4440-BBC0-B5E1C788BED0}
{E03988A2-D228-4F6A-A699-8E726762ACFA} = {865FECD4-7975-4440-BBC0-B5E1C788BED0}
{E5705BE4-784B-41B3-AD61-D4ABD7D5FAB2} = {92979E59-18CC-403E-B4F7-BE7433DE47F2}
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {D3B9C7C9-C3E5-4B27-8ED7-09C4EF2C594C}
Expand Down
8 changes: 4 additions & 4 deletions build/DocumentationTasks.fs
Original file line number Diff line number Diff line change
Expand Up @@ -9,27 +9,27 @@ open BlackFox.Fake
let buildDocs = BuildTask.create "BuildDocs" [build] {
printfn "building docs with stable version %s" stableVersionTag
runDotNet
(sprintf "fsdocs build --eval --clean --properties Configuration=Release --parameters fsdocs-package-version %s" stableVersionTag)
(sprintf "fsdocs build --clean --properties Configuration=Release --parameters fsdocs-package-version %s" stableVersionTag)
"./"
}

let buildDocsPrerelease = BuildTask.create "BuildDocsPrerelease" [setPrereleaseTag; build] {
printfn "building docs with prerelease version %s" prereleaseTag
runDotNet
(sprintf "fsdocs build --eval --clean --properties Configuration=Release --parameters fsdocs-package-version %s" prereleaseTag)
(sprintf "fsdocs build --clean --properties Configuration=Release --parameters fsdocs-package-version %s" prereleaseTag)
"./"
}

let watchDocs = BuildTask.create "WatchDocs" [build] {
printfn "watching docs with stable version %s" stableVersionTag
runDotNet
(sprintf "fsdocs watch --eval --clean --properties Configuration=Release --parameters fsdocs-package-version %s" stableVersionTag)
(sprintf "fsdocs watch --clean --properties Configuration=Release --parameters fsdocs-package-version %s" stableVersionTag)
"./"
}

let watchDocsPrerelease = BuildTask.create "WatchDocsPrerelease" [setPrereleaseTag; build] {
printfn "watching docs with prerelease version %s" prereleaseTag
runDotNet
(sprintf "fsdocs watch --eval --clean --properties Configuration=Release --parameters fsdocs-package-version %s" prereleaseTag)
(sprintf "fsdocs watch --clean --properties Configuration=Release --parameters fsdocs-package-version %s" prereleaseTag)
"./"
}
2 changes: 1 addition & 1 deletion build/ProjectInfo.fs
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ let project = "Sigma.NET"

let testProjects =
[
//"tests/Sigma.NET.Tests"
"tests/Sigma.NET.Tests"
]

let solutionFile = $"{project}.sln"
Expand Down
2 changes: 1 addition & 1 deletion build/build.fsproj
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>
<TargetFramework>net6.0</TargetFramework>
<TargetFramework>net8.0</TargetFramework>
<OutputType>Exe</OutputType>
</PropertyGroup>

Expand Down
86 changes: 86 additions & 0 deletions docs/1_Introduction.ipynb
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Introduction\n",
"## Library Name \n",
"Sigma.NET \n",
"Sigma.NET.Interactive \n",
"## Description\n",
"Sigma.NET is a powerful and easy-to-use library for visualizing graphs and networks that provides intuitive methods to create, customize, and display various types of graphs, making it suitable for both beginners and advanced users. Additionally, Sigma.NET.Interactive offers interactive visualization options, allowing users to explore and manipulate graphs in real-time for deeper insights and analysis.\n",
"\n",
"### Graphs\n",
"A graph is a mathematical structure used to model pairwise relationships between objects. It consists of a set of nodes (also called vertices) and a set of edges (also called links or connections) that connect pairs of nodes. Graphs are widely used in various fields such as computer science, biology, social sciences, and network science to represent and analyze networks.\n",
"\n",
"### Nodes (Vertices)\n",
"Nodes are the individual entities or points in a graph. Each node can represent a different object, such as a person in a social network, a gene in a biological network, or a computer in a communication network. Nodes are typically depicted as dots or circles in a graphical representation.\n",
"\n",
"### Edges (Links)\n",
"Edges are the connections between nodes in a graph. Each edge represents a relationship or interaction between two nodes. Edges can be directed or undirected:\n",
"\n",
"- **Undirected Edges**: Represent bidirectional relationships where the connection does not have a specific direction (e.g., friendship in a social network).\n",
"- **Directed Edges**: Represent unidirectional relationships where the connection has a specific direction (e.g., a follower relationship in Twitter).\n",
"\n",
"- **Weighted Edges**: Represent relationships where the connection carries a value or weight, indicating the strength or capacity of the link (e.g., the cost of traveling between two cities on a map).\n",
"\n",
"- **Unweighted Edges**: Represent relationships where the connection does not have a specific value or weight, treating all links as equal in terms of their significance (e.g., a simple link between nodes in a network graph).\n",
"\n",
"These basic concepts form the foundation for understanding and visualizing graphs.\n",
"\n",
"## Features:\n",
"\n",
"- Simple and intuitive API\n",
"- Customizable node and edge attributes\n",
"- Interactive visualization options\n",
"\n",
"## Installation\n",
"Using nuget"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"dotnet_interactive": {
"language": "fsharp"
},
"polyglot_notebook": {
"kernelName": "fsharp"
}
},
"outputs": [],
"source": [
"//Sigma.NET and Sigma.NET.Interactive\n",
"#i \"nuget: C:/Users/lukas/Documents/GitHub/Project/Sigma.NET/pkg\"\n",
"#r \"nuget: Sigma.NET, 0.0.0-dev\"\n",
"#r \"nuget: Sigma.NET.Interactive, 0.0.0-dev\"\n",
"\n",
"open Sigma.NET\n",
"open Sigma.NET.Interactive"
]
}
],
"metadata": {
"kernelspec": {
"display_name": ".NET (F#)",
"language": "F#",
"name": ".net-fsharp"
},
"polyglot_notebook": {
"kernelInfo": {
"defaultKernelName": "fsharp",
"items": [
{
"aliases": [],
"languageName": "fsharp",
"name": "fsharp"
}
]
}
}
},
"nbformat": 4,
"nbformat_minor": 2
}
Loading

0 comments on commit 5dd1518

Please sign in to comment.