1 # Created by Octave 3.6.1, Fri Mar 23 19:03:15 2012 UTC <root@t61>
13 # name: <cell-element>
17 -- Function File: FPL2dxappenddata ( FILENAME,
18 P, T, U, ATTR_NAME, ATTR_RANK, ATTR_SHAPE, ENDFLIE )
20 Apends data to a file in DX form. Only one variable can be
21 written to the file variable must be a scalar, vector or tensor
22 of doubles mesh data in the file must be consistent with this
25 Variable must be a scalar, vector or tensor of doubles
27 - FILENAME= name of file to save (type string)
31 - U = variable to save
33 - ATTR_NAME = name of the variable (type string)
35 - ATTR_RANK = rank of variable data (0 for scalar, 1 for
38 - ATTR_SHAPE = number of components of variable data (assumed
41 - ENDFILE = 0 if you want to add other variables to the same
47 # name: <cell-element>
51 P, T, U, ATTR_NAME, ATTR_RANK, ATTR_SHAPE, ENDFLIE )
56 # name: <cell-element>
63 # name: <cell-element>
67 -- Function File: FPL2dxoutputdata ( FILENAME, P, T, U, ATTR_NAME,
68 ATTR_RANK, ATTR_SHAPE, ENDFILE )
69 Outputs data in DX form.
71 Variable must be a scalar, vector or tensor of doubles
73 - FILENAME= name of file to save (type string)
77 - U = variable to save
79 - ATTR_NAME = name of the variable (type string)
81 - ATTR_RANK = rank of variable data (0 for scalar, 1 for
84 - ATTR_SHAPE = number of components of variable data (assumed
87 - ENDFILE = 0 if you want to add other variables to the same
93 # name: <cell-element>
97 Outputs data in DX form.
101 # name: <cell-element>
105 FPL2dxoutputtimeseries
108 # name: <cell-element>
112 -- Function File: FPL2dxoutputtimeseries ( FILENAME, P, T, U,
113 ATTR_NAME, ATTR_RANK, ATTR_SHAPE, TIME )
114 Outputs a time series in DX form. variable must be a scalar,
115 vector or tensor of doubles
116 - FILENAME= name of file to save (type string)
120 - U = variable to save
122 - ATTR_NAME = name of the variable (type string)
124 - ATTR_RANK = rank of variable data (0 for scalar, 1 for
127 - ATTR_SHAPE = number of components of variable data (assumed
130 - TIME = time instants
135 # name: <cell-element>
139 Outputs a time series in DX form.
143 # name: <cell-element>
150 # name: <cell-element>
154 -- Function File: FPL2pdequiver (MESH, VX, VY, [ PROPERTY, VALUE ...])
155 Plots the 2D vector field VX, VY defined on the triangulation MESH
158 Options (default values): SAMPLE_DENSITY (100)
160 See also: FPL2pdesurf, FPL2ptcsurf, FPL2ptcquiver
166 # name: <cell-element>
170 Plots the 2D vector field VX, VY defined on the triangulation MESH
175 # name: <cell-element>
182 # name: <cell-element>
186 -- Function File: FPL2pdeshowmesh (MESH,COLOR)
187 Displays one 2-D triangulations using opendx
191 FPL2pdeshowmesh(mesh)
192 FPL2pdeshowmesh(mesh,"blue")
194 See also: FPL2ptcshowmesh
200 # name: <cell-element>
204 Displays one 2-D triangulations using opendx
209 # name: <cell-element>
216 # name: <cell-element>
220 -- Function File: FPL2pdesurf (MESH, U [ PROPERTY, VALUE ...])
221 plots the scalar field U defined on the triangulation MESH using
224 options (default value):
225 - data_dep ("positions") defines wether data depends on
226 positions or connections
228 - plot_field ("scalar") defines wether to plot the scalar field
229 itself or its gradient
231 See also: MSH2Mgmsh, MSH2Mstructmesh
237 # name: <cell-element>
241 plots the scalar field U defined on the triangulation MESH using opendx.
245 # name: <cell-element>
252 # name: <cell-element>
256 -- Function File: FPL2ptcquiver (MESH1, COLOR1
257 VX1, VY1, [ MESH2, COLOR2, VX2, VY2 ...])
259 Plots the 2D vector fields VX, VY defined on the triangulations
262 See also: FPL2pdesurf, FPL2ptcsurf, FPL2pdequiver
268 # name: <cell-element>
272 VX1, VY1, [ MESH2, COLOR2, VX2, VY2 .
276 # name: <cell-element>
283 # name: <cell-element>
287 -- Function File: FPL2ptcshowmesh (MESH1, COLOR1, [MESH2, COLOR2,
289 Displays two or more 2-D triangulations using opendx
291 See also: FPL2pdeshowmesh
297 # name: <cell-element>
301 Displays two or more 2-D triangulations using opendx
306 # name: <cell-element>
313 # name: <cell-element>
317 -- Function File: FPL2ptcsurf (MESH1, COLOR1, DATA1 [MESH2,
319 Plots the scalar fields DATA over the triangulation MESH using
320 opendx. Connections will be displayed as defined in COLOR.
326 # name: <cell-element>
330 Plots the scalar fields DATA over the triangulation MESH using opendx.
334 # name: <cell-element>
341 # name: <cell-element>
345 -- Function File: FPL2trspdesurf (MESH, COLOR, DATA)
346 Plots the transient scalar field U defined on the triangulation
347 MESH using opendx. Connections are rendered as defined by COLOR
351 FPL2trspdesurf(mesh,"blue",data)
353 See also: FPL2pdesurf, FPL2ptcsurf, FPL2trsptcsurf
359 # name: <cell-element>
363 Plots the transient scalar field U defined on the triangulation MESH
368 # name: <cell-element>
375 # name: <cell-element>
379 -- Function File: FPL2trsptcsurf (MESH1, COLOR1, DATA1, [MESH2,
381 Plots the transient scalar fields DATA defined on the triangulation
382 MESH using opendx. Connections are rendered as defined by COLOR
386 FPL2trspdesurf(mesh1,"blue",data1, mesh2,"red",data2)
388 See also: FPL2pdesurf, FPL2ptcsurf, FPL2trspdesurf
394 # name: <cell-element>
398 Plots the transient scalar fields DATA defined on the triangulation
403 # name: <cell-element>
410 # name: <cell-element>
414 -- Function File: FPL2vtkoutputdata ( FILENAME, P, T, NODEDATA,
415 CELLDATA, HEADER, VTKVER)
416 Save data in VTK ASCII format.
418 - FILENAME = name of file to save into
420 - P, T = mesh node coordinates and connectivity
422 - NAME = name of a mesh variable
424 - NODEDATA/CELLDATA = node/cell centered data fields
425 (2xNfields cell array), *DATA{:,1} = variable names;
426 *DATA{:,2} = variable data;
428 - HEADER comment to add in the file header
430 - VTKVER format version (default is 3.0)
432 See also: FPL2dxoutputdata
438 # name: <cell-element>
442 Save data in VTK ASCII format.
446 # name: <cell-element>
453 # name: <cell-element>
457 -- Function File: FPL3dxoutputfield( FILENAME, MESHFILENAME, DEP, U,
458 ATTR_NAME, ATTR_RANK, ATTR_SHAPE, ENDFILE )
459 Outputs data in DX form.
461 Variable must be a scalar, vector or tensor of doubles
463 - FILENAME = name of file to save (type string)
465 - MESHFILENAME = name of mesh file (type string)
467 - DEP = "positions" for node data, "connections" for
470 - FIELD = field data to be saved
472 - ATTR_NAME = name of the variable (type string)
474 - ATTR_RANK = rank of variable data (0 for scalar, 1 for
477 - ATTR_SHAPE = number of components of variable data
478 (assumed 1 for scalar)
483 # name: <cell-element>
487 Outputs data in DX form.
491 # name: <cell-element>
498 # name: <cell-element>
502 -- Function File: FPL3dxoutputmesh ( FILENAME, MESH )
503 Outputs data in DX form.
505 Variable must be a scalar, vector or tensor of doubles
507 - FILENAME = name of file to save (type string)
509 - MESH = PDE-tool like mesh
514 # name: <cell-element>
518 Outputs data in DX form.
522 # name: <cell-element>
529 # name: <cell-element>
533 -- Function File: fpl_dx_writefield (BASENAME, MESH, U, ATTR_NAME,
534 ATTR_RANK, ATTR_SHAPE, ENDFILE)
535 Output data field in ASCII Open-DX format.
537 BASENAME is a string containing the base-name of the dx file where
538 the data will be saved.
540 MESH is a PDE-tool like mesh, like the ones generated by the "msh"
543 U is the field to be saved. It should represent scalar, vector or
546 ATTR_NAME is a descriptive name for the field U, while ATTR_RANK
547 is the rank of the field (0 for scalar, 1 for vector, etc.) and
548 ATTR_SHAPE is the number of components of the field (assumed 1 for
551 ENDFILE should be 0 if you want to add other variables to the same
554 Notice that when appending fields to an already existing file:
556 * MESH will not be printed to FILENAME, but it will be only
557 used to determine if the field is piece-wise constant or
560 * U is not checked for consistency against the MESH already
563 Example 1 (wrong usage):
564 <generate msh1/u1 msh2/u2 in some way>
565 fpl_dx_write_field("field.dx",msh1,u1,"density",1,0,0);
566 fpl_dx_write_field("field.dx",msh2,u2,"temperature",1,0,1);
567 generate a file that fails at OpenDX run-time.
570 <generate msh1 and two fields u1-u2 in some way>
571 fpl_dx_write_field("field",msh1,u1,"density",1,0,0);
572 fpl_dx_write_field("field",msh1,u2,"temperature",1,0,1);
573 will generate a valid OpenDX ASCII data file.
575 See also: fpl_dx_write_series
581 # name: <cell-element>
585 Output data field in ASCII Open-DX format.
589 # name: <cell-element>
596 # name: <cell-element>
600 -- Function File: fpl_dx_write_series (BASENAME, MESH, U, SP,
601 ATTR_NAME, ATTR_RANK, ATTR_SHAPE)
602 Output data series in ASCII Open-DX format.
604 BASENAME is a string containing the base-name of the dx file where
605 the data will be saved.
607 MESH is a PDE-tool like mesh, like the ones generated by the "msh"
610 U is the series to be saved. It should represent scalar, vector or
611 tensor of doubles. SP is the vector of the sampled points (e.g.
612 time points in the case of a time series).
614 ATTR_NAME is a descriptive name for the series U, while ATTR_RANK
615 is the rank of the field items (0 for scalar, 1 for vector, etc.)
616 and ATTR_SHAPE is the number of components of the field items
617 (assumed 1 for scalar).
619 See also: fpl_dx_write_field
625 # name: <cell-element>
629 Output data series in ASCII Open-DX format.
633 # name: <cell-element>
640 # name: <cell-element>
644 -- Function File: fpl_vtk_write_field (BASENAME, MESH, NODEDATA,
646 Output data field in serial XML-VTK UnstructuredGrid format.
648 BASENAME is a string containing the base-name of the (vtu) file
649 where the data will be saved.
651 MESH is a PDE-tool like mesh, like the ones generated by the "msh"
654 NODEDATA and CELLDATA are (Ndata x 2) cell arrays containing
655 respectively <PointData> and <CellData> representing scalars or
657 - *DATA{:,1} = variable data;
659 - *DATA{:,2} = variable names;
661 ENDFILE should be 0 if you want to add other variables to the same
665 <generate msh1, node centered field nc1, cell centered field cc1>
666 fpl_vtk_write_field("example",msh1,{nc1, "temperature"}, {cc1, "density"},0);
667 <generate msh2, node centered field nc2>
668 fpl_vtk_write_field("example",msh2,{nc2, "temperature"}, {},1);
669 will generate a valid XML-VTK UnstructuredGrid file.
671 See also: fpl_dx_write_field, fpl_dx_write_series
677 # name: <cell-element>
681 Output data field in serial XML-VTK UnstructuredGrid format.
685 # name: <cell-element>
692 # name: <cell-element>
696 -- Function File: H = pdemesh (P, E, T, U)
697 Plot a triangular mesh in 3D given a mesh structure and node data.
698 P, T are the mesh vertices and connectivity, U node data. E is
699 ignored and is accepted only for compatibiity.
701 See also: fpl_dx_write_field, fpl_vtk_write_field
707 # name: <cell-element>
711 Plot a triangular mesh in 3D given a mesh structure and node data.
715 # name: <cell-element>
722 # name: <cell-element>
726 -- Function File: H = pdesurf (P, T, U)
727 Plot a 3D surface given node or element data on a triangular mesh.
728 P, T are the mesh vertices and connectivity, U node or element
731 See also: fpl_dx_write_field, fpl_vtk_write_field
737 # name: <cell-element>
741 Plot a 3D surface given node or element data on a triangular mesh.