This manual aims at giving you a short overview of the software functionnalities and to provide some guidelines for your first steps with nonsmooth systems simulation with Siconos. There you will learn basics things to know to describe a nonsmooth problem or to run a simulation using siconos, for both APIs, C++ or Python. For a more detailed description of Siconos and its functionnalities please check the Full documentation table of content.

Siconos is an open-source scientific software primarily targeted at modeling and simulating nonsmooth dynamical systems [AB08]:

**Mechanical systems**(rigid or solid) with unilateral contact and Coulomb friction and impact (Nonsmooth mechanics, contact dynamics, multibody systems dynamics or granular materials).**Switched Electrical Circuits**such as electrical circuits with ideal and piecewise linear components: power converter, rectifier, Phase-Locked Loop (PLL) or Analog-to-Digital converter.- Sliding mode control systems.
- Biology Gene regulatory networks.

Other applications are found in Systems and Control (hybrid systems, differential inclusions, optimal control with state constraints), Optimization (Complementarity systems and Variational inequalities), Fluid Mechanics, Computer Graphics, …

Check Browse examples manual for an overview of the various problems handled with Siconos.

The easiest way to start with Siconos : try tutorial notebooks available here :

This page propose a Python interactive interface (notebooks) to Siconos, that you can use through your web browser, online.

- Download Siconos the software
- Build and install
- Run your first simulation.

There are two ways to use Siconos

- As a library (C++) : in that case you need to write a c++ file (driver) to describe and solve your problem, and then run siconos to build and execute your program.
- As a Python package.

Python API is generated (swig) from C++ and thus both API are quite equivalent although C++ might be more complete.

Anyway, for new users we recommend the Python API which is easier to understand.

Below are two examples (Python and C++) of a Siconos process. We just build and print a first-order dynamical
system (See `FirstOrderLineraDS`

).

**Example of Siconos Python API usage**

```
# import siconos package
import siconos.kernel as sk
# import numpy package
import numpy as np
# Create a dynamical system
size = 10
x0 = np.random.random(size)
ds = sk.FirstOrderLineraDS(x0)
print(ds)
```

**Example of Siconos C++ API usage**

Write a c++ file, e.g. run.cpp

```
#include "SiconosKernel.hpp"
int main()
{
unsigned int size = 10;
SP::SiconosVector x0(new SiconosVector(size));
SP::SimpleMatrix A(new SimpleMatrix(size, size));
A->randomize();
SP::FirstOrderLinearDS ds(new FirstOrderLinearDS(x0, A));
ds->display();
}
```

And, compile, link and execute (in one shot, thanks to siconos script):

```
siconos run.cpp
```

For new simulation, start with the template for c++ driver file or try to mimic one of the examples distributed with the software (https://github.com/siconos/siconos/tree/master/examples).

We should sort, clean, update the followings …

- Modeling Principle
- Python interface : tutorials
- Siconos tutorials in C++
- Simulation of an electrical oscillator supplying a resistor through a half-wave rectifier
- Description of the physical problem : electrical oscillator with half-wave rectifier
- Definition of a general abstract class of NSDS : the linear time invariant complementarity system (LCS)
- Description of the numerical simulation: the Moreau’s time-stepping scheme
- Comparison with numerical results coming from SPICE models and algorithms

- Running a simulation
- C++ Refresher