EDEM2.2.1-programming-guide

EDEM2.2.1ProgrammingGuideRevision1EDEMProgrammingGuideCopyrightsandTrademarksCopyright©2010DEMSolutions.Allrightsreserved.Informationinthisdocumentissubjecttochangewithoutnotice.Thesoftwaredescribedinthisdocumentisfurnishedunderalicenseagreementornondisclosureagreement.Thesoftwaremaybeusedorcopiedonlyinaccordancewiththetermsofthoseagreements.Nopartofthispublicationmaybereproduced,storedinaretrievalsystem,ortransmittedinanyformoranymeanselectronicormechanical,includingphotocopyingandrecordingforanypurposeotherthanthepurchaser’spersonalusewithoutthewrittenpermission.DEMSolutions49QueenStreetEdinburghEH23NHUK©TranscenDataEuropeLimited,2007.AllRightsReserved.ThissoftwareisbasedinpartontheworkoftheIndependentJPEGGroup.EDEMusestheMersenneTwisterrandomnumbergenerator,Copyright©1997-2002,MakotoMatsumotoandTakujiNishimura,Allrightsreserved.EDEMincludesCGNS(CFDGeneralNotationSystem)software.SeetheOnlineHelpforfullcopyrightnotice.EDEMandParticleFactoryaretrademarksorregisteredtrademarksofDEMSolutionsintheUnitedKingdomand/orothercountries.FLUENTisaregisteredtrademarkofANSYS,Inc.intheUnitedStatesand/orothercountries.Otherbrandsandtheirproductsaretrademarksorregisteredtrademarksoftheirrespectiveholdersandshouldbenotedassuch.2EDEMProgrammingGuideContentsOverview...........................................................................................................................5 EDEMPluginDevelopmentProcess.............................................................................5 EDEMSimulationSequence.........................................................................................6 EDEMAPIFiles.............................................................................................................7 PluginContactModels......................................................................................................9 ContactModelAPIv2.0.0............................................................................................10 DevelopingaPluginContactModel............................................................................11 UsingtheNewContactModel.................................................................................15 UsingtheEDEMAnalysttoVerifytheContactModel.............................................16 PluginContactModelExamples..................................................................................19 ExamplePluginContactModel:Cohesion...............................................................19 ExamplePluginContactModel:Hertz-Mindlin.........................................................19 ExamplePluginContactModel:LinearSpring........................................................19 ExamplePluginContactModel:BondedParticle....................................................20 ExamplePluginContactModel:MovingPlane........................................................20 PluginParticleBodyForces............................................................................................21 ParticleBodyForcesAPIv2.0.0..................................................................................22 DevelopingaPluginParticleBodyForce....................................................................23 UsingtheNewParticleBodyForce.........................................................................26 PluginParticleBodyForceExamples.........................................................................27 ExamplePluginParticleBodyForce:BasicElectrostatics......................................27 ExamplePluginParticleBodyForce:FluidDrag.....................................................28 ExamplePluginParticleBodyForce:ResidenceTime............................................29 EDEMExtendedAPI.......................................................................................................30 FieldQueryAPI...............................................................................................................31 ManagerAPIv1.0........................................................................................................31 FieldManagerAPIv1.0...............................................................................................31 FieldAPIv1.0..............................................................................................................31 DevelopingaPluginusingtheFieldQueryAPI...........................................................32 PluginExternalParticleFactories...................................................................................35 ExternalParticleFactoryAPIv1.0.0............................................................................36 GETFACTINTERFACEVERSION(…)......................................................................37 GETFACTPREFERENCEFILE(…)..........................................................................38 CREATEPARTICLE(…).........................................