woo.tests

All defined functionality tests for woo.

woo.tests.testAll(sysExit=False)

Run all tests defined in all woo.tests.* modules. Return TestResult object for further examination. If sysExit is true, call sys.exit with status 0 (all tests passed), 1 (some tests failed), 2 (an exception was raised).

woo.tests.testModule(module)

Run all tests defined in the module specified, return TestResult object (http://docs.python.org/library/unittest.html#unittest.TextTestResult) for further processing.

@param module: fully-qualified module name, e.g. woo.tests.core

woo.tests.test_grid

class woo.tests.test_grid.TestGridColliderBasics(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testParams()

GridCollider: used-definable parameters

class woo.tests.test_grid.TestGridStore(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testAppend()

Grid: storage: appending data

testComplement()

Grid: storage: complements

testEx()

Grid: storage: dense and extra data

testPyAcces()

Grid: storage: python access

testStorageOrder()

Grid: storage: storage order

woo.tests.test_shapepack

class woo.tests.test_shapepack.TestShapePack(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

assertAlmostEqualRel(a, b, relerr, abserr=0)

testFromSim()

ShapePack: from/to simulation with particles

testGridSamping()

ShapePack: grid samping gives good approximations of mass+inertia

testLineEndings()

ShapePack: handle different line endings (LF, CR+LF, CR) gracefully

testLoadSampleTxt()

ShapePack: load sample text file

testSingle()

ShapePack: single particles not clumped when inserted into simulation

woo.tests.test_hertz

class woo.tests.test_hertz.TestHertz(methodName='runTest')

Test Law2_L6Geom_HertzPhys_DMT.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testElasticCollisionTime()

Hertz: elastic collision time for different impact velocities (simulation/analytic)

woo.tests.test_pbc

Various computations affected by the periodic boundary conditions.

class woo.tests.test_pbc.TestPBC(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testDegenerate()

PBC: degenerate cell raises exception

testHomotheticResizePos()

PBC: homothetic cell deformation adjusts particle position (homoDeform==’pos’)

testHomotheticResizeVel()

PBC: homothetic cell deformation adjusts particle velocity (homoDeform==’vel’)

testKineticEnergy()

PBC: Particle.getEk considers only fluctuation velocity, not the velocity gradient (homoDeform==’vel2’)

testKineticEnergy_homoPos()

PBC: Particle.Ekt considers only fluctuation velocity, not the velocity gradient (homoDeform==’pos’)

testL3GeomIncidentVelocity_homoPos()

PBC: L6Geom incident velocity (homoDeform==’pos’)

testL6GeomIncidentVelocity()

PBC: L6Geom incident velocity (homoDeform==’gradV2’)

testSetBox()

PBC: setBox modifies hSize correctly

testTrsfChange()

PBC: chaing trsf changes hSize0, but does not modify hSize

testVelGrad()

PBC: velGrad changes hSize but not hSize0, accumulates in trsf (homoDeform=’vel2’)

class woo.tests.test_pbc.TestPBCCollisions(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testCrossBoundarySort()

PBC: InsertionSortCollider correctly sorts on the boundary (bug #… discovered by Bruno)

testDoubleContact()

PBC: InsertionSortCollider raises on double-contact of large particles accross the cell

testInitSortAxis()

PBC: initial sort in InsertionSortCollider handles infinite dimensions correctly

testNormalContact()

PBC: InsertionSortCollider computes collisions and cellDist correctly

testOverHalfContact()

PBC: InsertionSortCollider handles particle spanning more than half cell-size

woo.tests.test_io

Test loading and saving woo objects in various formats

class woo.tests.test_io.TestArraySerialization(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testBoostMultiArray()

IO: serialization of boost::multi_array

testMatrixX()

IO: serialization of arrays

class woo.tests.test_io.TestFormatsAndDetection(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testBin()

IO: binary save/load & format detection

testBinGz()

IO: binary save/load (gzip compressed) & format detection

testDeepcopy()

IO: temporary store (Object.deepcopy)

testExpr()

IO: expression dump/load & format detection (file+string)

testExprHashColonOverride()

IO: special comments #% inside expr dumps

testExprSpecialComments()

IO: special comments #: inside expr dumps

testHtml()

IO: HTML dump (file+string)

testInvalidExtension()

IO: unrecognized extension rejected with format=’auto’

testInvalidFormat()

IO: invalid formats rejected

testJson()

IO: JSON dump/load & format detection (file+string)

testPickle()

IO: pickle dump/load & format detection (file+string)

testPickleEigen()

IO: pickling/unpickling Eigen objects

testRefuseDerivedPyObject()

IO: python-derived objects refuse to save via boost::serialization.

testStrFile()

IO: file can be given as str

testTmpStore()

IO: temporary store (loadTmp, saveTmp)

testUnicodeFile()

IO: filename can be given as unicode

testXml()

IO: XML save/load & format detection

testXmlBz2()

IO: XML save/load (bzip2 compressed) & format detection

tryDumpLoad(fmt='auto', ext='', load=True)

tryDumpLoadStr(fmt, load=True)

class woo.tests.test_io.TestNoDumpAttributes(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testCond()

IO: conditional dumping to expr and JSON

testUncond()

IO: unconditional noDump attribute (template param)

class woo.tests.test_io.TestSpecialDumpMethods(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testSceneLastDump_direct()

IO: Scene.lastSave set (Object._boostSave overridden)

woo.tests.test_tetra

class woo.tests.test_tetra.TestTet4(methodName='runTest')

Test woo.fem.Tet4.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testStiffnessMatrix()

Tet4: stiffness matrix

woo.tests.test_labels

class woo.tests.test_labels.TestSceneLabels(methodName='runTest')

Test LabelMapper and related functionality.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testAccess()

LabelMapper: access

testAutoLabel()

LabelMapper: labeled engines are added automatically

testDel()

LabelMapper: delete

testDir()

LabelMapper: __dir__

testEngineLabels()

LabelMapper: engine/functor labels (mix of older tests)

testGetattrIndexed()

LabelMapper: getattr with index

testHasattr()

LabelMapper: __hasattr__

testMixedSeq()

LabelMapper: mixed sequences rejected, undetermined accepted

testOpaqueSeqWithWooObjs()

LabelMapper: opaque sequence types with Woo objects are rejected

testPseudoModules()

LabelMapper: pseudo-modules

testSeq()

LabelMapper: sequences

testShared()

LabelMapper: shared objects

testString()

LabelMapper: strings and bytes

testWritable()

woo.tests.test_ellipsoid

class woo.tests.test_ellipsoid.TestEllipsoid(methodName='runTest')

Test Cg2_Ellipsoid_Ellipsoid_L6Geom.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testMassInertia()

Ellipsoid: mass and inertia computation

testNormalDisplacementEllipsoid()

Ellipsoid: normal displacement on contact with ellipsoid.

testNormalDisplacementWall()

Ellipsoid: normal displacement on contact with wall

woo.tests.test_core

Core functionality (Scene in c++), such as accessing bodies, materials, interactions. Specific functionality tests should go to engines.py or elsewhere, not here.

class woo.tests.test_core.TestArrayAccu(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testPreserveResize()

OpenMP array accu: preserve old data on resize

testPyConverter()

OpenMP array accu: to-python conversion

testResize()

OpenMP array accu: resizing

testThreadWrite()

OpenMP array accu: concurrent writes

class woo.tests.test_core.TestContact(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testForceSign()

Contact: forceSign

class woo.tests.test_core.TestForce(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

class woo.tests.test_core.TestIO(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testSaveAllClasses()

I/O: All classes can be saved and loaded with boost::serialization

class woo.tests.test_core.TestInteractions(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

class woo.tests.test_core.TestLoop(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testDead()

Loop: dead engines are not run

testEnginesModificationInsideLoop()

Loop: Scene.engines can be modified inside the loop transparently.

testNoneEngine()

Loop: None engine raises exception.

testPausedContext()

Loop: “with Scene.paused()” context manager

testStopAtHook()

Loop: S.stopAtHook

testStopAtStep()

Loop: S.stopAtStep and S.run(steps=…)

testStopAtTime()

Loop: S.stopAtTime and S.run(time=…)

testSubstepping()

Loop: substepping

testWait()

Loop: Scene.wait() returns only after the current step finished

testWaitException()

Loop: Scene.wait() returns on exception

testWaitForScenes()

Loop: Master.waitForScenes correctly handles reassignment of the master scene

testWaitTimeout()

Loop: Scene.wait(timeout=…)

class woo.tests.test_core.TestObjectInstantiation(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testBits()

Core: AttrTrait.bits accessors

testClassCtors()

Core: correct types are instantiated

testContactLoopCtor()

Core: ContactLoop special ctor

testDeepcopy()

Core: Object.deepcopy

testDeprecated()

Core: AttrTrait.deprecated raises exception on access

testDispatcherCtor()

Core: dispatcher ctors with functors

testHidden()

Core: Attr::hidden

testHidden_static()

Core: Attr::hidden (static)

testInvalidAttr()

Core: invalid attribute access raises AttributeError

testNamedEnum()

Core: Attr::namedEnum

testNamedEnum_static()

Core: Attr::namedEnum (static)

testNoSave()

Core: Attr::noSave

testNoSave_static()

Core: Attr::noSave (static)

testNodeDataCtorAssign()

Core: assign node data using shorthands in the ctor

testNotifyDead()

Core: PeriodicEngine::notifyDead

testParallelEngineCtor()

Core: ParallelEngine special ctor

testPyRunnerCtor()

Core: PyRunner with positional args

testReadonly()

Core: Attr::readonly

testReaonly_static()

Core: Attr::readonly (static)

testRootDerivedCtors_attrs_few()

Core: class ctor’s attributes

testShared()

Core: shared_ptr really shared

testSharedAfterReload()

Core: shared_ptr preserved when saving/loading

testTriggerPostLoad()

Core: postLoad & Attr::triggerPostLoad

testUnicodeStrConverter()

Core: std::string attributes can be assigned unicode string

testWrongFunctorType()

Core: dispatcher and functor type mismatch is detected

class woo.tests.test_core.TestParticles(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testIterate()

Particles: iteration

testLen()

Particles: len(S.dem.par)

testNegativeIndex()

Particles: negative index counts backwards (like python sequences).

testRemove()

Particles: acessing removed particles raises IndexError

testRemoveShrink()

Particles: removing particles shrinks storage size

testRemovedIterate()

Particles: iterator silently skips erased particles

class woo.tests.test_core.TestPyDerived(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testBoostDumpError()

PyDerived: refuses to dump with boost::serialization format (data loss)

testBoostSaveError()

PyDerived: refuses to save via Object::save (data loss; dump must be used instead)

testDeprecated()

PyDerived: deprecated attribute raises ValueError on access

testIniDefault()

PyDerived: default initialization

testIniUser()

PyDerived: user initialization (python parent)

testPickle()

PyDerived: deepcopy

testPickle2()

PyDerived: deepcopy (python parent)

testStrValidation()

PyDerived: string choice is validated

testTraits()

PyDerived: PyAttrTraits

testTrigger()

PyDerived: postLoad trigger (python parent)

testTypeCoerceCtor()

PyDerived: type coercion (ctor)

testTypeCoerceFloats()

PyDerived: type coercion (primitive types)

testTypeCoerceObject()

PyDerived: type coercion (woo.core.Object)

woo = <module 'woo' from '/home/runner/.local/lib/python3.8/site-packages/woo/__init__.py'>

class woo.tests.test_core.TestScene(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

class woo.tests.test_core.TestTags(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

_TestPyClass

Object → _TestPyClass

class woo.tests.test_core._TestPyClass(self: woo.core.Object) → None

Sample pure-python class integrated into woo (mainly used with preprocessors), for use with TestPyDerived.

[py/tests/test_core.py]

aF(= 1.0)

float attr

[type: float]

aFF(= [0.0, 1.0, 2.0])

list of floats attr

[type: [float, …]]

aV2(= Vector2(0, 1))

vector2 attr

[type: Vector2]

aVV2(= [Vector2(0,0), Vector2(1,1)])

list of vector2 attr

[type: [Vector2, …]]

aNode(= <Node @ 0x37ce930, at (1, 1, 1)>)

node attr

[type: Node]

aNodeNone(= None)

node attr, uninitialized

[type: Node]

aNNode(= [<Node @ 0x30df740, at (1,1,1)>, <Node @ 0x36b9640, at (2,2,2)>])

List of nodes

[type: [Node, …]]

aF_trigger(= 1.0)

Float triggering postLoad, copying its value to aF

[type: float]

postLoadCounter(= 0)

counter for postLoad (readonly). Incremented by 1 after construction, incremented by 10 when assigning to aF_trigger.

[type: int]

deprecAttr(= -1)

deprecated, here should be the explanation.

[type: int, not shown in the UI, not dumped, DEPRECATED, raises ValueError when accessed]

sChoice(= 'aa')

String choice attribute

[type: str, choices: aa, bb, cc]

PAT

alias of woo.pyderived.PyAttrTrait

static __new__(klass, **kw)

__repr__(self: woo.core.Object) → str

__str__(self: woo.core.Object) → str

deepcopy(**kw)

The c++ dedepcopy uses boost::serialization, we need to use pickle. As long as deepcopy is called from python, this function gets precedence over the c++ one. Additional keyword parameters are used to immediately set parameters on the copy before returning.

save(self: woo.core.Object, filename: str) → None

_TestPyClass2

Object → _TestPyClass → _TestPyClass2

class woo.tests.test_core._TestPyClass2(self: woo.core.Object) → None

Python class deriving from python base class (which in turn derives from c++).

[py/tests/test_core.py]

f2(= 0)

Float attr in derived class

[type: int]

f2counter(= 0)

Count how many times was f2 manipulated (to test triggerPostLoad in class with python parent)

[type: int]

static __new__(klass, **kw)

__repr__(self: woo.core.Object) → str

__str__(self: woo.core.Object) → str

deepcopy(**kw)

The c++ dedepcopy uses boost::serialization, we need to use pickle. As long as deepcopy is called from python, this function gets precedence over the c++ one. Additional keyword parameters are used to immediately set parameters on the copy before returning.

save(self: woo.core.Object, filename: str) → None

woo.tests.test_energy

Test some parts of energy conservation in DEM simulations.

class woo.tests.test_energy.TestInletsAndOutlets(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testConveyorInlet()

Energy: conveyor inlet traces kinetic energy

testRandomInlet()

Energy: random box factory traces kinetic energy

class woo.tests.test_energy.TestLeapfrog(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testDampingSkip()

Energy: DemData.dampingSkip

testGravitySkip()

Energy: DemData.gravitySkip

woo.tests.test_volumetric

class woo.tests.test_volumetric.TestVolumetric(methodName='runTest')

Volumetric properties

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testTetraCanon()

Tetra: mass, centrer, inertia of canonical tetrahedron

testTetraGeneric()

Tetra: inertia and principal axes of generic tetrahedron

testTetraUnit()

Tetra: principal axes of unit tetrahedron

testTriCanon()

Triangle: area, inertia of canonical triangle

woo.tests.test_batch

class woo.tests.test_batch.TestBatchResults(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testHdf5()

Batch: results in HDF5 (store/read/XLS(X)/CSV)

woo.tests.test_demfield

Test loading and saving woo objects in various formats

class woo.tests.test_demfield.TestContactLoop(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testUpdatePhys()

DEM: ContactLoop.updatePhys: never, always, once

class woo.tests.test_demfield.TestDemField(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testGuessMoving()

DEM: correctly guess that Node.dem needs motion integration

class woo.tests.test_demfield.TestImpose(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testCombinedImpose()

DEM: CombinedImpose created from Impose()+Impose()

testCombinedImposeFunction()

DEM: CombinedImpose combines impositions

testInterpolatedMotion()

DEM: InterpolatedMotion computes correct position and rotation

testUselessRotationImpose()

DEM: selfTest error when imposing rotation on aspherical particles (would have no effect)

testVariableVelocity3d_rot()

DEM: VariableVelocity3d imposition (angular velocity)

woo.tests.test_clump

Various computations affected by the periodic boundary conditions.

class woo.tests.test_clump.TestSimpleClump(methodName='runTest')

Test things on a simple clump composed of 2 spheres.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testConsistency()

Clump: ids and flags consistency

testNoCollide()

Clump: particles inside one clump don’t collide with each other

testStaticProperties()

Clump: mass, centroid, intertia

testVelocity()

Clump: velocities of member assigned by Leapfrog

class woo.tests.test_clump.TestSphereClumpGeom(methodName='runTest')

Clump: geometry of clumps composed of spheres only

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

setUp()

Hook method for setting up the test fixture before exercising it.

testSampling()

SphereClumpGeom: properties via grid sampling

testSteiner()

SphereClumpGeom: properties via Steiner’s theorem

woo.tests.test_clump.sphereClumpPrincipalAxes(cc, rr)

Clump: return vol,pos,ori,inertia of sphere clump defined by centers and radii of spheres

woo.tests.test_clustering

Tests for the new woo.dem.ClusterAnalysis.

class woo.tests.test_clustering.TestClusterAnalysis(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testZeroConnClustering()

clustering: simple zero-connectivity clustering

woo.tests.test_psd

Test particle generator, that the resulting PSD curve matches the one on input.

class woo.tests.test_psd.BiasedPositionTest(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

testAxialBias()

Inlet: axial bias

class woo.tests.test_psd.PsdSphereGeneratorTest(methodName='runTest')

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

checkOk(relDeltaInt=0.02, relDeltaD=0.04)

setUp()

Hook method for setting up the test fixture before exercising it.

testClippingSpuriousPoints()

PSD: clipping spurious values

testMassContinuous()

PSD: continuous mass-based generator

testMassDiscrete()

PSD: discrete mass-based generator

testMonodisperse()

PSD: monodisperse packing

testNoDumpAttrs()

PSD: ParticleGenerator.genDiamMassTime not dumped into expr/json

testNumContinuous()

PSD: continuous number-based generator

testNumDiscrete()

PSD: discrete number-based generator

testPsdTimeRange()

PSD: time range for computing PSD

Tip

Report issues or inclarities to github.