From BlenderWiki

Jump to: navigation, search
Sverchok tools
Custom nodes tools, that makes architectural (initial term) parametric in blender become true.
UI location Node Editor > Custom nodes > Add nodes
Version 0.2.7 Author(s) Alexander Nedovzin, Nikita Gorodetskiy, Agustin Jimenez, Linus Yng, Dealga McArdle
Blender 2.69 License GPL3


Executable information
File name __init__.py
Current version download http://github.com/nortikin/sverchok
Data 2014-01-12


Links Bugs & ChangeLog: http://www.blenderartists.org/forum/showthread.php?272679-Addon-WIP-Sverchok-parametric-tool-for-architects, homesite: http://nikitron.cc.ua/sverchok.html



What is Sverchok

  • Sverchok IS a tool for generating parametric geometry. We plan on supporting these features until version 2.0.
  • Sverchok IS NOT a complete node-based redesign of Blender's UI. It does not support node based particles, lighting etc.
  • Sverchok does not incorporate elements of pynodes' framework spector, because we are focused on a different aim - generating geometry. We are interested in developing Sverchok to work cooperatively with other node systems such as Lukas Toene's node based particle systems.
  • Main developing line: MATH + MESH + SPLINES + NURBS.

Screenshots

Sverchok is a tool that allows you to generate parametric and procedural forms and geometry with nodes, without having to know any programming or scripting languages.

Sverchok-interface1.png
Sverchok nikitron-spreads-.png
Newplane.3d.gif
Plane-line-new.png
Untitled4.png
Распредвал4.png
Error creating thumbnail: Invalid thumbnail parameters
press for full size image
adaptive polygons 3d
adaptive polygons nodes
cross section 3d
cross section nodes
cross section 3d
cross section nodes
snowfly nodes
snowfly nodes
snowfly nodes
snowfly nodes
snowfly nodes
Error creating thumbnail: Invalid thumbnail parameters
DrWEB press for full size image
Error creating thumbnail: Invalid thumbnail parameters
particles press for full size image

I don't know why these gif images animations do not fit to the thumbnails. They are just full-sized


How to Use

Installation

Install the add-on by opening User Preferences and selecting "Install from file..." in the Add-ons tab. Check the checkbox on the right.

  1. Установка сверчка
  2. install sverchok
  3. instruction on Github

Blendersushi posts about sverchok

  1. sverchok-get-to-know
  2. sverchok-connecting-dots
  3. sverchok-random-and-mask-list
  4. sverchok-when-python-plays-with-cricket
  5. sverchok-seeing-matrix
  6. sverchok-procedural-flower-and-leaf
  7. sverchok-revisiting-procedural-stacking
  8. sverchok-basic-of-procedural-city
  9. sverchok-in-between-blends
  10. sverchok-sweep-swipe-swoop
  11. sverchok-embracing-art-of-parametric
  12. sverchok-parametric-snippets-1
  13. Sverchok - parametric design study of ball
  14. Sverchok - parametric snippets 2
  15. Sverchok - in between strands of threads
  16. Sverchok - procedural city wip
  17. Sverchok - parametric snippets 3
  18. Sverchok - parametric snippets 4
  19. Sverchok - parametric snippets 5
  20. Sverchok - basic of semi procedural
  21. Sverchok - flower and snake (+18)
  22. Sverchok - parametric snippets 6
  23. Sverchok - parametric snippets 7

Уроки на русском языке! === Lessons in Russian!

  1. Установка сверчка
  2. Путь сверчка
  3. Структура данных сверчка
  4. Карточки новых узлов (до 2014 года)
  5. Соединение объектов сверчок старый метод
  6. Стадион имени В.И.Ленина в сверчке, первая генеративная модель
  7. Материализация объектов, столы сделаны в сверчке
  8. Узел пользовательский. Программирование в песочнице сверчка, смогут все.
  9. Соединение вершин, поверхности и простая интерполяция.

Data structure and sockets (slots on nodes)

FOR DETAILED INSTRUCTIONS ON DATA LOOK HERE: Data structure of sverchok


Sverchok has specific data structure:

  What is data in Sverchok:
 
  [[(x0,y0,z0),(x1,y1,z1),(x2,y2,z2)][...     ]...]  that is how it looks 0,1,2,3
0 [                                               ]  socket's container list - essential
1  [object 0                        ][object 1]...   object, matrix, as one list, as many objects so many lists here
2   (vert 0  ),(vert 1  ),(vert 2  )  (...   )       lists
3    x0,y0,z0   x1,y1,z1   x2,y2,z2                  integers, floats

Sockets are:

  1. Vertices socket represent vectors, that define mesh (vertices are vectors and vice versa):
Vertices tree:
 
  [[(x,y,z)]]
0 [ object,... ]
1 obect = [ v... ]
2 v = (x,y,z)
3 x,y,z = float,float,float
  1. Edges/Polygons/Data socket. cat transfer any data, simply used for create lists, floats, and used as lists of edges and polygons. in viewer it define itself, which kind of data you connect, if in list two elements - it is edges (connect integers), if in list more than two - it is polygons and automatically it draws polygons in 3d view or bake it to blender object with mesh.
Edges/polygons tree:
 
  [[(n...)]]
0 [ object ]
1 object = [pol...]
2 pol = [n,n,n,n,n]
3 n = integer
  1. Matrixes consists of 4 lines at 4 floats, it defines rotation, scale, translation. It is mathimatically usefull to operate with matrixes. Only one matrix for one object. To draw several objects with the same mesh, you have to connect several matrixes, each of it defines object's location, rotation, scale.
Matrixes tree:
 
  [[(x,y,z,w)]]
0 [ matrix ]
1 matrix = (a,b,c,d)
2 a,b,c,d = (x,y,z,w)...
3 x,y,z,w = float

Nikitron 17:59, 22 April 2014 (CEST)


Nodes

Basic

  1. Tools01-0.jpg Tools01-1.jpg Objects in - take data from object
  2. Bake all - bakes all geometry on fly - under development
  3. Tools02-0.jpg Tools02-1.jpg Viewer draw - draw data in OpenGL and bakes viewed object
  4. Tools03-0.jpg Tools03-1.jpg Viewer text - show data in "text editor" in "Sverchok text" file
  5. Viewer INDX - show vertices indeces in 3D. lesson howto index
  6. Tools04-0.jpgTools - update all nodes, help, home site, feedback
  7. Wifi in - node to take sockets' values without wires on layout. Needed personal naming in special field to be the same as in output wifi. Work in pare.
  8. Wifi out - node to give sockets' values without wires on layout. Needed personal naming in special field to be the same as in input wifi. Work in pare.
  9. Text in - takes data from text file. Lesson_1, lesson_2
  10. Text out - makes data writed to text in some format - cvs, sverchok or other type. Than you can export it to some format
  11. Frame info - takes current frame, start, end frames
  12. Note - lets you leave notes on layout note node showed

Nikitron 17:59, 22 April 2014 (CEST)

List

  1. List 01.jpg List Levels - leave selected levels and delete other levels of nasted lists
  2. List 02.jpg List Join - joins some lists in many ways
  3. List 03.jpg List Zip - join several objects from one socket, but can join lists
  4. List 04.jpg List Shift - shift items to some value usefull in polygons definition
  5. List 05.jpg List Reverse - make list 1,2,3,4,5,6 reversed as 6,5,4,3,2,1
  6. List 06.jpg List Length - length of selected list level
  7. List 07.jpg List Sum - Sum of all items in list (floats and int)
  8. List 08.jpg List First&Last - get first and last item in list on selected data level
  9. List Item - pick item
  10. List Repeater - repeat some user-defined level's list some user-defined times
  11. List Math - operates with lists - takes maximum value, minimum value and avarage value
  12. List Flip - flip some level of list that row becomes column and vise versa
  13. List Mask - mask by another boolean list
  14. List Sort - sort list
  15. List Shuffle - randomise list
  16. List Match - making one list match in length for another and vice versa. One ca be shorten, cycled prolonged or repeated prolonged in different levels
  17. Socket convert - temporery solution till we have adaptive sockets universal

Nikitron 17:59, 22 April 2014 (CEST)

Number

  1. List 09.jpg Series - makes range of floats
  2. Range - the same, but diapason devided by division's count
  3. List input - creates list from exact values as many as needed
  4. List 10.jpg Random - makes so many rendom floats as you tell him. Random from 0 to 1
  5. List 11.jpg Float - make float value
  6. List 12.jpg Int - make integer value
  7. List 13.jpg Float 2 Int - make integer from float
  8. List 14.jpg Formula - calculate values by some expressions defined by user (+, -, /, *, min, max, sin, cos, etc.)
  9. Math - math functions in one node
  10. List 15.jpg Formula2 - support vector*vector, define hierarhy and calculate respectfully to it. Supporting additionally to formula:
        acos()
        acosh()
        asin()
        asinh()
        atan()
        atan2()
        atanh()
        ceil()
        copysign()
        cos()
        cosh()
        degrees()
        e
        erf()
        erfc()
        exp()
        expm1()
        fabs()
        factorial()
        floor()
        fmod()
        frexp()
        fsum()
        gamma()
        hypot()
        isfinite()
        isinf()
        isnan()
        ldexp()
        lgamma()
        log()
        log10()
        log1p()
        log2()
        modf()
        pi
        pow()
        radians()
        sin()
        sinh()
        sqrt()
        tan()
        tanh()
        trunc()
        ==
        !=
        <, >
        for, in, if, else
        []

and output to vector. Moreover, you can define lists with formula, i.e. 0,1,2,3,4,5 for series or (1,2,3),(1,2,3) for vertices Nikitron 17:59, 22 April 2014 (CEST)

Generators

  1. Vec 01.jpg Line - fully makes line - vertices and edges, can take series of steps
  2. Vec 02.jpg Plane - fully makes plane grid with steps and number of dots, as line do
  3. Box - could be subdivided on X,Y,Z
  4. Cyrcle - could be segmented or chorded
  5. Cylinder - subdivisions in height
  6. Sphere - usual Sphere
  7. Hilbert - Гильбертово пространство, квадрат всегда
  8. Hilbert Image - hilbert from image
  9. Voronoi - makes voronoi 2D field from vectors
  10. Image - mesh defined by image
  11. Random Vector - makes unit normal vectors in random values
  12. Scripted Node - you making script and node appears. details lesson how to make your custom script, lesson how to bind your script to script node
elements of scripts
sintaxis in details
Here are the current implementation rules for node-loadable scripts for Scripted Node:
We have simplifyed syntax - no need if than wxpression with {0}... See templates
  • the main working function must be called sv_main
  • function def must have input variables and defaults. It could be def sv_main(veriable=12) for integers/floats defaults or def sv_main(veriable=[]) for lists and series of floats/integers
  • must have in_sockets and out_sockets , as shown in examples and return them
  • you can create three types of in/out sockets:
  1. 'v' - Vectors socket
  2. 's' - edges/polygons/numbers/else socket
  3. 'm' - matrices socket
it looks like:
in_sockets = [
['s', 'Vertices', data],
['s', 'Step', step],
]
  • you can define def sv_main(**your_veriables_here**): and press CTRL+I in text area to automake veriables in in_sockets list. All for your convenient.
Please, use templates in node (popup and button)

Nikitron 23:48, 3 May 2014 (CEST)

Vectors

Vector - is list of three floats (x,y,z), defining 3D situation of one dot

Matrix - here you can find links to educate what is matrix - is three vectors responsible for Location, Scale, Rotation. We define that or change or multiply.

  1. Vec 03.jpg Vector in - make Vector
  2. Vec 04.jpg Vector out - destruct vector to XYZ
  3. Vec 05.jpg Vector normal - gives normal of vector from polygoons and vertices
  4. Vec 06.jpg Vector Move - moves vectors to another verctors
  5. Vector Math - Basic Vector functions in one node. Add, Sub, Normal, Distance, Projection, Cross Product, etc
  6. Matrix apply - apply matrix (locatin, rotation, scale) to vertices, similar to ctrl+A in blender
  7. Vector Drop - makes polygons turned to floor, as they lay on floor. usefull for farthere usage in bezier curve 2D operations and making easy DWG layout to plot or something else. Here we have usage of Vector Drop
  8. Vector X Doubles - remove doubled vertices (twiced node with other in modifiers - need to be removed doubled itself. that irony)
  9. Vector Evaluate - find points from one point to other - can have minus values and more than 1
  10. Vertices Sort - sorting vertices at one direction or another
  11. Matrix Apply - apply Tra/Rot/Sca values to vertices as alt+A
  12. Vec 07.jpg Matrix in - generate matrix
  13. Vec 08.jpg Matrix out - destroy matrix to location and scale
  14. Vec 09.jpg Matrix Deform - define scale, rotate or translate matrixes. It is able to rotate matrix with two vectors: Put initial vector to Rotation Axis vector socket and second to Angle. It will rotate on difference between angles Rot-Ang. It is showed in Spider example file on official site's examples.
  15. Shear Matrix - makes matrix to shear as shift up to one side, bottom to another, for example lesson how to shear
  16. Matrix interpolation - defines "mutations" for middle-deformed matrixes.

Modifier

  1. Vec 10.jpg Centers Polygons - find polygon's centers
  2. Vec 12.jpg Adaptive polygons - makes donor object spreads on recipient object adaptively to each polygon's corners. Donor has to be square on base, and base square has to locate on local zero Z-axis. Lesson how to adaptive polygons
  3. Adaptive Edges - replace some edge of recipient with donor's edges.
  4. Vec 13.jpg Cross Section old - makes section between object and plane. Plane - it is matrix' XY plane, so many matrixes makes many sections
  5. Bisect new - makes crossection with more functions and quicker Here we have how to bisect (cross section)
  6. Solidify - makes mesh extruded
  7. Wireframe - makes wireframed mesh
  8. Line Connection - by edges/polygons (not fully ended) Lesson how to line connection
  9. Delanuary 2D - makes polygons from vectors
  10. Voronoi - makes voronoi edged mesh in floor, 2D frm defined points
  11. Polygon Boom - separates polygons to objects and dropping them to zero point - here we have polygon boom usage
  12. Polygons to Edges - converts polygons to edges Lesson how to polygon to edge
  13. Mesh Join - join several meshes with preserve of vertex indexes in polygons/edges
  14. Mesh Remove Doubles - removes doubled vercites and polygons and edges
  15. Delete Loose - deleting free vertices left from edges/pols, that use some vertices
  16. Convex Hull - as Delaunay node makes triangles on vertices, but in 3D
  17. Intersect edges - finding intersections of edges

Analiser

  1. Vec 11.jpg Distances - find distances between matrixes or vertices
  2. Area - area of polygons and theyr's sum
  3. KDTree vertices - finding closest point to other points list
  4. KDTree edges - creating edges based on distance between vertices