    

 ## On this page

  

 

 # rocky\_particle

 Last update: 16.07.2025 

<a id="l00001" name="l00001"></a> 1// (C) 2024 ANSYS, Inc. Unauthorized use, distribution, or duplication is prohibited.

<a id="l00002" name="l00002"></a> 2\#pragma once

<a id="l00003" name="l00003"></a> 3 

<a id="l00004" name="l00004"></a> 4// Includes =======================================================================================

<a id="l00005" name="l00005"></a> 5\#include &lt;rocky20/api/device/api\_backend.hpp&gt;

<a id="l00006" name="l00006"></a> 6\#include &lt;rocky20/api/rocky\_particle\_scalars.hpp&gt;

<a id="l00007" name="l00007"></a> 7\#include &lt;rocky20/device/device\_model.hpp&gt;

<a id="l00008" name="l00008"></a> 8\#include &lt;rocky20/device/element\_properties.hpp&gt;

<a id="l00009" name="l00009"></a> 9 

<a id="l00010" name="l00010"></a> 10class cuda_host;

<a id="l00011" name="l00011"></a> 11typedef cuda_host RockyModel;

<a id="l00012" name="l00012"></a> 12 

<a id="l00013" name="l00013"></a> 13// ================================================================================================

<a id="l00014" name="l00014"></a> 14// RockyParticle

<a id="l00015" name="l00015"></a> 15// ================================================================================================

<a id="l00016" name="l00016"></a> 16struct RockyParticle

<a id="l00017" name="l00017"></a> 17{

<a id="l00018" name="l00018"></a> 18 // States --------------------------------------------------------------------------------------

<a id="l00019" name="l00019"></a> 19 

<a id="l00020" name="l00020"></a> 20 inline ROCKY_FUNCTIONS bool is_active() const

<a id="l00021" name="l00021"></a> 21 {

<a id="l00022" name="l00022"></a> 22 return this-&gt;particle-&gt;active();

<a id="l00023" name="l00023"></a> 23 }

<a id="l00024" name="l00024"></a> 24 

<a id="l00025" name="l00025"></a> 25 inline ROCKY_FUNCTIONS void set_active(const bool active = true) const

<a id="l00026" name="l00026"></a> 26 {

<a id="l00027" name="l00027"></a> 27 this-&gt;particle-&gt;set_active(active);

<a id="l00028" name="l00028"></a> 28 }

<a id="l00029" name="l00029"></a> 29 

<a id="l00030" name="l00030"></a> 30 inline ROCKY_FUNCTIONS bool is_released() const

<a id="l00031" name="l00031"></a> 31 {

<a id="l00032" name="l00032"></a> 32 return this-&gt;particle-&gt;released();

<a id="l00033" name="l00033"></a> 33 }

<a id="l00034" name="l00034"></a> 34 

<a id="l00035" name="l00035"></a> 35 inline ROCKY_FUNCTIONS bool is_enabled() const

<a id="l00036" name="l00036"></a> 36 {

<a id="l00037" name="l00037"></a> 37 return this-&gt;particle-&gt;enabled();

<a id="l00038" name="l00038"></a> 38 }

<a id="l00039" name="l00039"></a> 39 

<a id="l00040" name="l00040"></a> 40 inline ROCKY_FUNCTIONS void set_enabled(const bool enabled = true) const

<a id="l00041" name="l00041"></a> 41 {

<a id="l00042" name="l00042"></a> 42 this-&gt;particle-&gt;set_enabled(enabled);

<a id="l00043" name="l00043"></a> 43 }

<a id="l00044" name="l00044"></a> 44 

<a id="l00045" name="l00045"></a> 45 inline ROCKY_FUNCTIONS bool is_frozen() const

<a id="l00046" name="l00046"></a> 46 {

<a id="l00047" name="l00047"></a> 47 return this-&gt;particle-&gt;frozen();

<a id="l00048" name="l00048"></a> 48 }

<a id="l00049" name="l00049"></a> 49 

<a id="l00050" name="l00050"></a> 50 inline ROCKY_FUNCTIONS void set_frozen(const bool frozen = true) const

<a id="l00051" name="l00051"></a> 51 {

<a id="l00052" name="l00052"></a> 52 this-&gt;particle-&gt;set_frozen(frozen);

<a id="l00053" name="l00053"></a> 53 }

<a id="l00054" name="l00054"></a> 54 

<a id="l00055" name="l00055"></a> 55 inline ROCKY_FUNCTIONS bool is_new_release() const

<a id="l00056" name="l00056"></a> 56 {

<a id="l00057" name="l00057"></a> 57 return this-&gt;particle-&gt;new_release();

<a id="l00058" name="l00058"></a> 58 }

<a id="l00059" name="l00059"></a> 59 

<a id="l00060" name="l00060"></a> 60 inline ROCKY_FUNCTIONS bool has_linked_motion() const

<a id="l00061" name="l00061"></a> 61 {

<a id="l00062" name="l00062"></a> 62 return this-&gt;particle-&gt;has_linked_motion();

<a id="l00063" name="l00063"></a> 63 }

<a id="l00064" name="l00064"></a> 64 

<a id="l00065" name="l00065"></a> 65 inline ROCKY_FUNCTIONS void set_particle_contact_disabled(const bool disabled = true)

<a id="l00066" name="l00066"></a> 66 {

<a id="l00067" name="l00067"></a> 67 this-&gt;particle-&gt;set_particle_contact_disabled(disabled);

<a id="l00068" name="l00068"></a> 68 }

<a id="l00069" name="l00069"></a> 69 

<a id="l00070" name="l00070"></a> 70 inline ROCKY_FUNCTIONS void set_triangle_contact_disabled(const bool disabled = true)

<a id="l00071" name="l00071"></a> 71 {

<a id="l00072" name="l00072"></a> 72 this-&gt;particle-&gt;set_triangle_contact_disabled(disabled);

<a id="l00073" name="l00073"></a> 73 }

<a id="l00074" name="l00074"></a> 74 

<a id="l00075" name="l00075"></a> 75 inline ROCKY_FUNCTIONS void set_remove_from_contacts_search(const bool remove = true)

<a id="l00076" name="l00076"></a> 76 {

<a id="l00077" name="l00077"></a> 77 this-&gt;particle-&gt;set_remove_from_contacts_search(remove);

<a id="l00078" name="l00078"></a> 78 }

<a id="l00079" name="l00079"></a> 79 

<a id="l00080" name="l00080"></a> 80 inline ROCKY_FUNCTIONS void remove()

<a id="l00081" name="l00081"></a> 81 {

<a id="l00082" name="l00082"></a> 82 this-&gt;particle-&gt;set_active(false);

<a id="l00083" name="l00083"></a> 83 this-&gt;particle-&gt;set_enabled(false);

<a id="l00084" name="l00084"></a> 84 }

<a id="l00085" name="l00085"></a> 85 

<a id="l00086" name="l00086"></a> 86 inline ROCKY_FUNCTIONS bool is_element() const

<a id="l00087" name="l00087"></a> 87 {

<a id="l00088" name="l00088"></a> 88 if (this-&gt;model-&gt;prt_geo != nullptr)

<a id="l00089" name="l00089"></a> 89 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].is_particle_element();

<a id="l00090" name="l00090"></a> 90 return false;

<a id="l00091" name="l00091"></a> 91 }

<a id="l00092" name="l00092"></a> 92 

<a id="l00093" name="l00093"></a> 93 inline ROCKY_FUNCTIONS bool is_meshed_parent() const

<a id="l00094" name="l00094"></a> 94 {

<a id="l00095" name="l00095"></a> 95 if (this-&gt;model-&gt;prt_geo != nullptr)

<a id="l00096" name="l00096"></a> 96 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].is_meshed_parent_particle();

<a id="l00097" name="l00097"></a> 97 return false;

<a id="l00098" name="l00098"></a> 98 }

<a id="l00099" name="l00099"></a> 99 

<a id="l00100" name="l00100"></a> 100 inline ROCKY_FUNCTIONS bool is_assembly() const

<a id="l00101" name="l00101"></a> 101 {

<a id="l00102" name="l00102"></a> 102 return this-&gt;get_group().is_assembly();

<a id="l00103" name="l00103"></a> 103 }

<a id="l00104" name="l00104"></a> 104 

<a id="l00105" name="l00105"></a> 105 inline ROCKY_FUNCTIONS bool is_non_round() const

<a id="l00106" name="l00106"></a> 106 {

<a id="l00107" name="l00107"></a> 107 return this-&gt;get_group().is_non_round();

<a id="l00108" name="l00108"></a> 108 }

<a id="l00109" name="l00109"></a> 109 

<a id="l00110" name="l00110"></a> 110 inline ROCKY_FUNCTIONS void set_as_unbreakable() const

<a id="l00111" name="l00111"></a> 111 {

<a id="l00112" name="l00112"></a> 112 this-&gt;model-&gt;particle_scalars-&gt;get_breakage_state(this-&gt;particle_index)

<a id="l00113" name="l00113"></a> 113 .set_as_unbreakable();

<a id="l00114" name="l00114"></a> 114 }

<a id="l00115" name="l00115"></a> 115 

<a id="l00116" name="l00116"></a> 116 // Indices -------------------------------------------------------------------------------------

<a id="l00117" name="l00117"></a> 117 

<a id="l00118" name="l00118"></a> 118 inline ROCKY_FUNCTIONS int get_particle_group_index() const

<a id="l00119" name="l00119"></a> 119 {

<a id="l00120" name="l00120"></a> 120 if (this-&gt;group_index &lt; 0)

<a id="l00121" name="l00121"></a> 121 const\_cast&lt;int&amp;&gt;(this-&gt;group_index) = this-&gt;particle-&gt;get_group_index();

<a id="l00122" name="l00122"></a> 122 return this-&gt;group_index;

<a id="l00123" name="l00123"></a> 123 }

<a id="l00124" name="l00124"></a> 124 

<a id="l00125" name="l00125"></a> 125 inline ROCKY_FUNCTIONS int get_global_index() const

<a id="l00126" name="l00126"></a> 126 {

<a id="l00127" name="l00127"></a> 127 return this-&gt;particle-&gt;id_g;

<a id="l00128" name="l00128"></a> 128 }

<a id="l00129" name="l00129"></a> 129 

<a id="l00130" name="l00130"></a> 130 inline ROCKY_FUNCTIONS int get_inlet_index() const

<a id="l00131" name="l00131"></a> 131 {

<a id="l00132" name="l00132"></a> 132 return this-&gt;particle-&gt;ninl;

<a id="l00133" name="l00133"></a> 133 }

<a id="l00134" name="l00134"></a> 134 

<a id="l00135" name="l00135"></a> 135 inline ROCKY_FUNCTIONS int get_gpu_index() const

<a id="l00136" name="l00136"></a> 136 {

<a id="l00137" name="l00137"></a> 137 return int(this-&gt;particle-&gt;gpu_id);

<a id="l00138" name="l00138"></a> 138 }

<a id="l00139" name="l00139"></a> 139 

<a id="l00140" name="l00140"></a> 140 inline ROCKY_FUNCTIONS void set_gpu_index(const int index)

<a id="l00141" name="l00141"></a> 141 {

<a id="l00142" name="l00142"></a> 142 this-&gt;particle-&gt;gpu_id = char(index);

<a id="l00143" name="l00143"></a> 143 }

<a id="l00144" name="l00144"></a> 144 

<a id="l00145" name="l00145"></a> 145 inline ROCKY_FUNCTIONS int get_dgb_tetra_index() const

<a id="l00146" name="l00146"></a> 146 {

<a id="l00147" name="l00147"></a> 147 if (this-&gt;model-&gt;prt_geo != nullptr)

<a id="l00148" name="l00148"></a> 148 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].dgb_tetra_index;

<a id="l00149" name="l00149"></a> 149 return -2;

<a id="l00150" name="l00150"></a> 150 }

<a id="l00151" name="l00151"></a> 151 

<a id="l00152" name="l00152"></a> 152 inline ROCKY_FUNCTIONS int get_dgb_parent_index() const

<a id="l00153" name="l00153"></a> 153 {

<a id="l00154" name="l00154"></a> 154 if (this-&gt;model-&gt;prt_geo != nullptr)

<a id="l00155" name="l00155"></a> 155 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].dgb_parent_index;

<a id="l00156" name="l00156"></a> 156 return -2;

<a id="l00157" name="l00157"></a> 157 }

<a id="l00158" name="l00158"></a> 158 

<a id="l00159" name="l00159"></a> 159 inline ROCKY_FUNCTIONS int get_dgb_fragment_index() const

<a id="l00160" name="l00160"></a> 160 {

<a id="l00161" name="l00161"></a> 161 if (this-&gt;model-&gt;prt_geo != nullptr)

<a id="l00162" name="l00162"></a> 162 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].dgb_fragment_index;

<a id="l00163" name="l00163"></a> 163 return -2;

<a id="l00164" name="l00164"></a> 164 }

<a id="l00165" name="l00165"></a> 165 

<a id="l00166" name="l00166"></a> 166 inline ROCKY_FUNCTIONS int get_tag() const

<a id="l00167" name="l00167"></a> 167 {

<a id="l00168" name="l00168"></a> 168 const auto&amp; group = this-&gt;get_group();

<a id="l00169" name="l00169"></a> 169 if (group.meshing_type == pmt1DRegular)

<a id="l00170" name="l00170"></a> 170 {

<a id="l00171" name="l00171"></a> 171 const int element_index = group.elements_storage_start + this-&gt;get_dgb_tetra_index();

<a id="l00172" name="l00172"></a> 172 return this-&gt;model-&gt;flexible_element_data[element_index].tag;

<a id="l00173" name="l00173"></a> 173 }

<a id="l00174" name="l00174"></a> 174 else

<a id="l00175" name="l00175"></a> 175 {

<a id="l00176" name="l00176"></a> 176 return -1;

<a id="l00177" name="l00177"></a> 177 }

<a id="l00178" name="l00178"></a> 178 }

<a id="l00179" name="l00179"></a> 179 

<a id="l00180" name="l00180"></a> 180 // Related Entities ----------------------------------------------------------------------------

<a id="l00181" name="l00181"></a> 181 

<a id="l00182" name="l00182"></a> 182 inline ROCKY_FUNCTIONS ParticleType get_type() const

<a id="l00183" name="l00183"></a> 183 {

<a id="l00184" name="l00184"></a> 184 return static\_cast&lt;ParticleType&gt;(this-&gt;get_group().tpe);

<a id="l00185" name="l00185"></a> 185 }

<a id="l00186" name="l00186"></a> 186 

<a id="l00187" name="l00187"></a> 187 inline ROCKY_FUNCTIONS const cuda_particle_group&amp; get_group() const

<a id="l00188" name="l00188"></a> 188 {

<a id="l00189" name="l00189"></a> 189 return this-&gt;model-&gt;get_particle_group(this-&gt;get_particle_group_index());

<a id="l00190" name="l00190"></a> 190 }

<a id="l00191" name="l00191"></a> 191 

<a id="l00192" name="l00192"></a> 192 inline ROCKY_FUNCTIONS const cuda_material&amp; get_material() const

<a id="l00193" name="l00193"></a> 193 {

<a id="l00194" name="l00194"></a> 194 return this-&gt;model-&gt;get_material(this-&gt;get_group().get_material_index());

<a id="l00195" name="l00195"></a> 195 }

<a id="l00196" name="l00196"></a> 196 

<a id="l00197" name="l00197"></a> 197 inline ROCKY_FUNCTIONS size\_t get_number_of_assembly_parts() const

<a id="l00198" name="l00198"></a> 198 {

<a id="l00199" name="l00199"></a> 199 return this-&gt;get_group().n_elements;

<a id="l00200" name="l00200"></a> 200 }

<a id="l00201" name="l00201"></a> 201 

<a id="l00202" name="l00202"></a> 202 inline ROCKY_FUNCTIONS const cuda_material&amp; get_assembly_part_material(size\_t part_id) const

<a id="l00203" name="l00203"></a> 203 {

<a id="l00204" name="l00204"></a> 204 const cuda_particle_group&amp; group = this-&gt;get_group();

<a id="l00205" name="l00205"></a> 205 const auto&amp; part = this-&gt;model-&gt;assembly_data[group.elements_storage_start + part_id];

<a id="l00206" name="l00206"></a> 206 const cuda_particle_group&amp; part_group = this-&gt;model-&gt;get_particle_group(part.igr);

<a id="l00207" name="l00207"></a> 207 const auto&amp; part_material = this-&gt;model-&gt;get_material(part_group.get_material_index());

<a id="l00208" name="l00208"></a> 208 return part_material;

<a id="l00209" name="l00209"></a> 209 }

<a id="l00210" name="l00210"></a> 210 

<a id="l00211" name="l00211"></a> 211 inline ROCKY_FUNCTIONS const cuda_vertice_stor* get_vertices_array() const

<a id="l00212" name="l00212"></a> 212 {

<a id="l00213" name="l00213"></a> 213 return this-&gt;model-&gt;prt_vrt + this-&gt;model-&gt;prt_geo[this-&gt;particle_index].nv_str;

<a id="l00214" name="l00214"></a> 214 }

<a id="l00215" name="l00215"></a> 215 

<a id="l00216" name="l00216"></a> 216 inline ROCKY_FUNCTIONS int get_number_of_vertices() const

<a id="l00217" name="l00217"></a> 217 {

<a id="l00218" name="l00218"></a> 218 if (this-&gt;get_global_index() &lt; this-&gt;model-&gt;gen-&gt;nprt_nb)

<a id="l00219" name="l00219"></a> 219 return this-&gt;get_group().nvr;

<a id="l00220" name="l00220"></a> 220 else

<a id="l00221" name="l00221"></a> 221 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].nvr;

<a id="l00222" name="l00222"></a> 222 }

<a id="l00223" name="l00223"></a> 223 

<a id="l00224" name="l00224"></a> 224 // Material and Group Properties ---------------------------------------------------------------

<a id="l00225" name="l00225"></a> 225 

<a id="l00226" name="l00226"></a> 226 inline ROCKY_FUNCTIONS double get_density() const

<a id="l00227" name="l00227"></a> 227 {

<a id="l00228" name="l00228"></a> 228 const cuda_material&amp; material = this-&gt;get_material();

<a id="l00229" name="l00229"></a> 229 return material.dens;

<a id="l00230" name="l00230"></a> 230 }

<a id="l00231" name="l00231"></a> 231 

<a id="l00232" name="l00232"></a> 232 inline ROCKY_FUNCTIONS double get_original_mass() const

<a id="l00233" name="l00233"></a> 233 {

<a id="l00234" name="l00234"></a> 234 return this-&gt;particle-&gt;get_original_mass(this-&gt;model-&gt;inr_prp);

<a id="l00235" name="l00235"></a> 235 }

<a id="l00236" name="l00236"></a> 236 

<a id="l00237" name="l00237"></a> 237 inline ROCKY_FUNCTIONS double get_area() const

<a id="l00238" name="l00238"></a> 238 {

<a id="l00239" name="l00239"></a> 239 return this-&gt;particle-&gt;get_current_area(this-&gt;model-&gt;inr_prp);

<a id="l00240" name="l00240"></a> 240 }

<a id="l00241" name="l00241"></a> 241 

<a id="l00242" name="l00242"></a> 242 inline ROCKY_FUNCTIONS double get_size() const

<a id="l00243" name="l00243"></a> 243 {

<a id="l00244" name="l00244"></a> 244 return this-&gt;particle-&gt;get_current_size();

<a id="l00245" name="l00245"></a> 245 }

<a id="l00246" name="l00246"></a> 246 

<a id="l00247" name="l00247"></a> 247 inline ROCKY_FUNCTIONS double get_cgm_scale_factor() const

<a id="l00248" name="l00248"></a> 248 {

<a id="l00249" name="l00249"></a> 249 return this-&gt;get_group().cgm_scale_factor;

<a id="l00250" name="l00250"></a> 250 }

<a id="l00251" name="l00251"></a> 251 

<a id="l00252" name="l00252"></a> 252 inline ROCKY_FUNCTIONS double get_mass() const

<a id="l00253" name="l00253"></a> 253 {

<a id="l00254" name="l00254"></a> 254 return ParticleProperties::get_mass(

<a id="l00255" name="l00255"></a> 255 *this-&gt;particle,

<a id="l00256" name="l00256"></a> 256 this-&gt;particle_index,

<a id="l00257" name="l00257"></a> 257 this-&gt;model-&gt;inr_prp,

<a id="l00258" name="l00258"></a> 258 this-&gt;model-&gt;particle_scalars);

<a id="l00259" name="l00259"></a> 259 }

<a id="l00260" name="l00260"></a> 260 

<a id="l00261" name="l00261"></a> 261 inline ROCKY_FUNCTIONS double get_sphericity() const

<a id="l00262" name="l00262"></a> 262 {

<a id="l00263" name="l00263"></a> 263 if (this-&gt;get_type() != ptSpherical)

<a id="l00264" name="l00264"></a> 264 {

<a id="l00265" name="l00265"></a> 265 const double diameter = this-&gt;get_equivalent_diameter();

<a id="l00266" name="l00266"></a> 266 return M_PI * diameter * diameter / this-&gt;get_area();

<a id="l00267" name="l00267"></a> 267 }

<a id="l00268" name="l00268"></a> 268 return 1.0;

<a id="l00269" name="l00269"></a> 269 }

<a id="l00270" name="l00270"></a> 270 

<a id="l00271" name="l00271"></a> 271 inline ROCKY_FUNCTIONS double get_bulk_volume() const

<a id="l00272" name="l00272"></a> 272 {

<a id="l00273" name="l00273"></a> 273 return ParticleProperties::get_bulk_volume(

<a id="l00274" name="l00274"></a> 274 *this-&gt;particle,

<a id="l00275" name="l00275"></a> 275 this-&gt;particle_index,

<a id="l00276" name="l00276"></a> 276 this-&gt;model-&gt;inr_prp,

<a id="l00277" name="l00277"></a> 277 this-&gt;model-&gt;particle_scalars);

<a id="l00278" name="l00278"></a> 278 }

<a id="l00279" name="l00279"></a> 279 

<a id="l00280" name="l00280"></a> 280 inline ROCKY_FUNCTIONS double get_solid_volume() const

<a id="l00281" name="l00281"></a> 281 {

<a id="l00282" name="l00282"></a> 282 return ParticleProperties::get_solid_volume(

<a id="l00283" name="l00283"></a> 283 *this-&gt;particle,

<a id="l00284" name="l00284"></a> 284 this-&gt;particle_index,

<a id="l00285" name="l00285"></a> 285 this-&gt;model-&gt;inr_prp,

<a id="l00286" name="l00286"></a> 286 this-&gt;get_group(),

<a id="l00287" name="l00287"></a> 287 this-&gt;model-&gt;particle_scalars);

<a id="l00288" name="l00288"></a> 288 }

<a id="l00289" name="l00289"></a> 289 

<a id="l00290" name="l00290"></a> 290 inline ROCKY_FUNCTIONS double get_thermal_conductivity() const

<a id="l00291" name="l00291"></a> 291 {

<a id="l00292" name="l00292"></a> 292 return ParticleProperties::get_thermal_conductivity(

<a id="l00293" name="l00293"></a> 293 this-&gt;model-&gt;particle_scalars,

<a id="l00294" name="l00294"></a> 294 *this-&gt;particle,

<a id="l00295" name="l00295"></a> 295 this-&gt;particle_index,

<a id="l00296" name="l00296"></a> 296 this-&gt;get_material());

<a id="l00297" name="l00297"></a> 297 }

<a id="l00298" name="l00298"></a> 298 

<a id="l00299" name="l00299"></a> 299 inline ROCKY_FUNCTIONS void set_thermal_conductivity(double value)

<a id="l00300" name="l00300"></a> 300 {

<a id="l00301" name="l00301"></a> 301 this-&gt;model-&gt;particle_scalars-&gt;get_thermal_conductivity(this-&gt;particle_index) = value;

<a id="l00302" name="l00302"></a> 302 }

<a id="l00303" name="l00303"></a> 303 

<a id="l00304" name="l00304"></a> 304 inline ROCKY_FUNCTIONS double get_poisson_ratio() const

<a id="l00305" name="l00305"></a> 305 {

<a id="l00306" name="l00306"></a> 306 return ParticleProperties::get_poisson_ratio(

<a id="l00307" name="l00307"></a> 307 this-&gt;model-&gt;particle_scalars,

<a id="l00308" name="l00308"></a> 308 *this-&gt;particle,

<a id="l00309" name="l00309"></a> 309 this-&gt;particle_index,

<a id="l00310" name="l00310"></a> 310 this-&gt;get_material());

<a id="l00311" name="l00311"></a> 311 }

<a id="l00312" name="l00312"></a> 312 

<a id="l00313" name="l00313"></a> 313 inline ROCKY_FUNCTIONS void set_poisson_ratio(double value)

<a id="l00314" name="l00314"></a> 314 {

<a id="l00315" name="l00315"></a> 315 this-&gt;model-&gt;particle_scalars-&gt;get_poisson_ratio(this-&gt;particle_index) = value;

<a id="l00316" name="l00316"></a> 316 }

<a id="l00317" name="l00317"></a> 317 

<a id="l00318" name="l00318"></a> 318 inline ROCKY_FUNCTIONS double get_specific_heat() const

<a id="l00319" name="l00319"></a> 319 {

<a id="l00320" name="l00320"></a> 320 return ParticleProperties::get_specific_heat(

<a id="l00321" name="l00321"></a> 321 this-&gt;model-&gt;particle_scalars,

<a id="l00322" name="l00322"></a> 322 *this-&gt;particle,

<a id="l00323" name="l00323"></a> 323 this-&gt;particle_index,

<a id="l00324" name="l00324"></a> 324 this-&gt;get_material());

<a id="l00325" name="l00325"></a> 325 }

<a id="l00326" name="l00326"></a> 326 

<a id="l00327" name="l00327"></a> 327 inline ROCKY_FUNCTIONS void set_specific_heat(double value)

<a id="l00328" name="l00328"></a> 328 {

<a id="l00329" name="l00329"></a> 329 this-&gt;model-&gt;particle_scalars-&gt;get_specific_heat(this-&gt;particle_index) = value;

<a id="l00330" name="l00330"></a> 330 }

<a id="l00331" name="l00331"></a> 331 

<a id="l00332" name="l00332"></a> 332 inline ROCKY_FUNCTIONS double get_equivalent_diameter() const

<a id="l00333" name="l00333"></a> 333 {

<a id="l00334" name="l00334"></a> 334 return cbrt(6.0 * this-&gt;get_bulk_volume() / M_PI);

<a id="l00335" name="l00335"></a> 335 }

<a id="l00336" name="l00336"></a> 336 

<a id="l00337" name="l00337"></a> 337 inline ROCKY_FUNCTIONS double3 get_moment_of_inertia() const

<a id="l00338" name="l00338"></a> 338 {

<a id="l00339" name="l00339"></a> 339 return ParticleProperties::get_inertia_moment(

<a id="l00340" name="l00340"></a> 340 *this-&gt;particle,

<a id="l00341" name="l00341"></a> 341 this-&gt;particle_index,

<a id="l00342" name="l00342"></a> 342 this-&gt;model-&gt;inr_prp,

<a id="l00343" name="l00343"></a> 343 this-&gt;model-&gt;particle_scalars);

<a id="l00344" name="l00344"></a> 344 }

<a id="l00345" name="l00345"></a> 345 

<a id="l00346" name="l00346"></a> 346 inline ROCKY_FUNCTIONS double get_original_bulk_volume() const

<a id="l00347" name="l00347"></a> 347 {

<a id="l00348" name="l00348"></a> 348 return ParticleProperties::get_original_bulk_volume(*this-&gt;particle, this-&gt;model-&gt;inr_prp);

<a id="l00349" name="l00349"></a> 349 }

<a id="l00350" name="l00350"></a> 350 

<a id="l00351" name="l00351"></a> 351 inline ROCKY_FUNCTIONS double get_original_solid_volume() const

<a id="l00352" name="l00352"></a> 352 {

<a id="l00353" name="l00353"></a> 353 return ParticleProperties::get_original_solid_volume(

<a id="l00354" name="l00354"></a> 354 *this-&gt;particle, this-&gt;model-&gt;inr_prp, this-&gt;get_group());

<a id="l00355" name="l00355"></a> 355 }

<a id="l00356" name="l00356"></a> 356 

<a id="l00357" name="l00357"></a> 357 inline ROCKY_FUNCTIONS double get_original_size() const

<a id="l00358" name="l00358"></a> 358 {

<a id="l00359" name="l00359"></a> 359 return this-&gt;particle-&gt;get_original_size();

<a id="l00360" name="l00360"></a> 360 }

<a id="l00361" name="l00361"></a> 361 

<a id="l00362" name="l00362"></a> 362 inline ROCKY_FUNCTIONS double get_size_scale() const

<a id="l00363" name="l00363"></a> 363 {

<a id="l00364" name="l00364"></a> 364 return this-&gt;particle-&gt;get_size_scale();

<a id="l00365" name="l00365"></a> 365 }

<a id="l00366" name="l00366"></a> 366 

<a id="l00367" name="l00367"></a> 367 inline ROCKY_FUNCTIONS double get_minimum_fragment_size() const

<a id="l00368" name="l00368"></a> 368 {

<a id="l00369" name="l00369"></a> 369 return rocky::dmax(

<a id="l00370" name="l00370"></a> 370 this-&gt;get_group().br_inst_params.szmin,

<a id="l00371" name="l00371"></a> 371 this-&gt;get_group().br_inst_params.fr_szmin * this-&gt;get_original_size());

<a id="l00372" name="l00372"></a> 372 }

<a id="l00373" name="l00373"></a> 373 

<a id="l00374" name="l00374"></a> 374 inline ROCKY_FUNCTIONS SVectorAngleD get_orientation_axis_angle() const

<a id="l00375" name="l00375"></a> 375 {

<a id="l00376" name="l00376"></a> 376 return rocky::transform::quaternion_to_angle(this-&gt;get_orientation_quaternion());

<a id="l00377" name="l00377"></a> 377 }

<a id="l00378" name="l00378"></a> 378 

<a id="l00379" name="l00379"></a> 379 // Scalar Properties ---------------------------------------------------------------------------

<a id="l00380" name="l00380"></a> 380 

<a id="l00381" name="l00381"></a> 381 inline ROCKY_FUNCTIONS double get_strength() const

<a id="l00382" name="l00382"></a> 382 {

<a id="l00383" name="l00383"></a> 383 return this-&gt;model-&gt;particle_scalars-&gt;get_strength(this-&gt;particle_index);

<a id="l00384" name="l00384"></a> 384 }

<a id="l00385" name="l00385"></a> 385 

<a id="l00386" name="l00386"></a> 386 inline ROCKY_FUNCTIONS double get_release_time() const

<a id="l00387" name="l00387"></a> 387 {

<a id="l00388" name="l00388"></a> 388 return this-&gt;model-&gt;particle_scalars-&gt;get_release_time(this-&gt;particle_index);

<a id="l00389" name="l00389"></a> 389 }

<a id="l00390" name="l00390"></a> 390 

<a id="l00391" name="l00391"></a> 391 inline ROCKY_FUNCTIONS double3 get_centroid() const

<a id="l00392" name="l00392"></a> 392 {

<a id="l00393" name="l00393"></a> 393 return this-&gt;particle-&gt;get_centroid();

<a id="l00394" name="l00394"></a> 394 }

<a id="l00395" name="l00395"></a> 395 

<a id="l00396" name="l00396"></a> 396 inline ROCKY_FUNCTIONS void set_centroid(const double3&amp; centroid) const

<a id="l00397" name="l00397"></a> 397 {

<a id="l00398" name="l00398"></a> 398 this-&gt;particle-&gt;x = centroid.x;

<a id="l00399" name="l00399"></a> 399 this-&gt;particle-&gt;y = centroid.y;

<a id="l00400" name="l00400"></a> 400 this-&gt;particle-&gt;z = centroid.z;

<a id="l00401" name="l00401"></a> 401 }

<a id="l00402" name="l00402"></a> 402 

<a id="l00403" name="l00403"></a> 403 inline ROCKY_FUNCTIONS double3 get_translational_velocity() const

<a id="l00404" name="l00404"></a> 404 {

<a id="l00405" name="l00405"></a> 405 return this-&gt;model-&gt;prt_vel[this-&gt;particle_index].get_translational();

<a id="l00406" name="l00406"></a> 406 }

<a id="l00407" name="l00407"></a> 407 

<a id="l00408" name="l00408"></a> 408 inline ROCKY_FUNCTIONS void set_translational_velocity(const double3&amp; velocity) const

<a id="l00409" name="l00409"></a> 409 {

<a id="l00410" name="l00410"></a> 410 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].ux = velocity.x;

<a id="l00411" name="l00411"></a> 411 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].uy = velocity.y;

<a id="l00412" name="l00412"></a> 412 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].uz = velocity.z;

<a id="l00413" name="l00413"></a> 413 }

<a id="l00414" name="l00414"></a> 414 

<a id="l00415" name="l00415"></a> 415 inline ROCKY_FUNCTIONS double3 get_rotational_velocity() const

<a id="l00416" name="l00416"></a> 416 {

<a id="l00417" name="l00417"></a> 417 return this-&gt;model-&gt;prt_vel[this-&gt;particle_index].get_rotational();

<a id="l00418" name="l00418"></a> 418 }

<a id="l00419" name="l00419"></a> 419 

<a id="l00420" name="l00420"></a> 420 inline ROCKY_FUNCTIONS void set_rotational_velocity(const double3&amp; velocity) const

<a id="l00421" name="l00421"></a> 421 {

<a id="l00422" name="l00422"></a> 422 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].wx = velocity.x;

<a id="l00423" name="l00423"></a> 423 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].wy = velocity.y;

<a id="l00424" name="l00424"></a> 424 this-&gt;model-&gt;prt_vel[this-&gt;particle_index].wz = velocity.z;

<a id="l00425" name="l00425"></a> 425 }

<a id="l00426" name="l00426"></a> 426 

<a id="l00427" name="l00427"></a> 427 inline ROCKY_FUNCTIONS double4 get_orientation_quaternion() const

<a id="l00428" name="l00428"></a> 428 {

<a id="l00429" name="l00429"></a> 429 if (this-&gt;model-&gt;gen-&gt;flags.has_non_round_particles())

<a id="l00430" name="l00430"></a> 430 {

<a id="l00431" name="l00431"></a> 431 return this-&gt;model-&gt;prt_geo[this-&gt;particle_index].get_quaternion();

<a id="l00432" name="l00432"></a> 432 }

<a id="l00433" name="l00433"></a> 433 else if (this-&gt;model-&gt;particle_scalars-&gt;is_round_quaternion_enabled())

<a id="l00434" name="l00434"></a> 434 {

<a id="l00435" name="l00435"></a> 435 return this-&gt;model-&gt;particle_scalars-&gt;get_round_quaternion(this-&gt;particle_index);

<a id="l00436" name="l00436"></a> 436 }

<a id="l00437" name="l00437"></a> 437 else

<a id="l00438" name="l00438"></a> 438 {

<a id="l00439" name="l00439"></a> 439 return { 0, 0, 0, 1 }; // Identity quaternion

<a id="l00440" name="l00440"></a> 440 }

<a id="l00441" name="l00441"></a> 441 }

<a id="l00442" name="l00442"></a> 442 

<a id="l00443" name="l00443"></a> 443 inline ROCKY_FUNCTIONS void set_orientation_quaternion(const double4&amp; quaternion) const

<a id="l00444" name="l00444"></a> 444 {

<a id="l00445" name="l00445"></a> 445 if (this-&gt;model-&gt;gen-&gt;flags.has_non_round_particles())

<a id="l00446" name="l00446"></a> 446 {

<a id="l00447" name="l00447"></a> 447 rocky::transform::copy_quaternion(

<a id="l00448" name="l00448"></a> 448 this-&gt;model-&gt;prt_geo[this-&gt;particle_index].quat, quaternion);

<a id="l00449" name="l00449"></a> 449 }

<a id="l00450" name="l00450"></a> 450 else if (this-&gt;model-&gt;particle_scalars-&gt;is_round_quaternion_enabled())

<a id="l00451" name="l00451"></a> 451 {

<a id="l00452" name="l00452"></a> 452 this-&gt;model-&gt;particle_scalars-&gt;get_round_quaternion(this-&gt;particle_index) = quaternion;

<a id="l00453" name="l00453"></a> 453 }

<a id="l00454" name="l00454"></a> 454 }

<a id="l00455" name="l00455"></a> 455 

<a id="l00456" name="l00456"></a> 456 inline ROCKY_FUNCTIONS double get_temperature() const

<a id="l00457" name="l00457"></a> 457 {

<a id="l00458" name="l00458"></a> 458 return this-&gt;model-&gt;particle_scalars-&gt;get_temperature(this-&gt;particle_index);

<a id="l00459" name="l00459"></a> 459 }

<a id="l00460" name="l00460"></a> 460 

<a id="l00461" name="l00461"></a> 461 inline ROCKY_FUNCTIONS void set_temperature(const double temperature)

<a id="l00462" name="l00462"></a> 462 {

<a id="l00463" name="l00463"></a> 463 this-&gt;model-&gt;particle_scalars-&gt;get_temperature(this-&gt;particle_index) = temperature;

<a id="l00464" name="l00464"></a> 464 }

<a id="l00465" name="l00465"></a> 465 

<a id="l00466" name="l00466"></a> 466 // Transfer Scalar Properties ------------------------------------------------------------------

<a id="l00467" name="l00467"></a> 467 

<a id="l00468" name="l00468"></a> 468 inline ROCKY_FUNCTIONS double get_impact_energy() const

<a id="l00469" name="l00469"></a> 469 {

<a id="l00470" name="l00470"></a> 470 return this-&gt;model-&gt;particle_transfer_scalars-&gt;get_particle_impact_energy(particle_index);

<a id="l00471" name="l00471"></a> 471 }

<a id="l00472" name="l00472"></a> 472 

<a id="l00473" name="l00473"></a> 473 inline ROCKY_FUNCTIONS double3 get_forces() const

<a id="l00474" name="l00474"></a> 474 {

<a id="l00475" name="l00475"></a> 475 const cuda_particle_force&amp; prt_forces = this-&gt;model-&gt;frc[this-&gt;particle_index];

<a id="l00476" name="l00476"></a> 476 return double3 { prt_forces.fx, prt_forces.fy, prt_forces.fz };

<a id="l00477" name="l00477"></a> 477 }

<a id="l00478" name="l00478"></a> 478 

<a id="l00479" name="l00479"></a> 479 inline ROCKY_FUNCTIONS void set_forces(const double3&amp; forces)

<a id="l00480" name="l00480"></a> 480 {

<a id="l00481" name="l00481"></a> 481 cuda_particle_force&amp; prt_forces = this-&gt;model-&gt;frc[this-&gt;particle_index];

<a id="l00482" name="l00482"></a> 482 prt_forces.fx = forces.x;

<a id="l00483" name="l00483"></a> 483 prt_forces.fy = forces.y;

<a id="l00484" name="l00484"></a> 484 prt_forces.fz = forces.z;

<a id="l00485" name="l00485"></a> 485 }

<a id="l00486" name="l00486"></a> 486 

<a id="l00487" name="l00487"></a> 487 inline ROCKY_FUNCTIONS void add_forces(const double3&amp; forces)

<a id="l00488" name="l00488"></a> 488 {

<a id="l00489" name="l00489"></a> 489 cuda_particle_force&amp; prt_forces = this-&gt;model-&gt;frc[this-&gt;particle_index];

<a id="l00490" name="l00490"></a> 490 backend::atomic_add(&amp;prt_forces.fx, forces.x);

<a id="l00491" name="l00491"></a> 491 backend::atomic_add(&amp;prt_forces.fy, forces.y);

<a id="l00492" name="l00492"></a> 492 backend::atomic_add(&amp;prt_forces.fz, forces.z);

<a id="l00493" name="l00493"></a> 493 }

<a id="l00494" name="l00494"></a> 494 

<a id="l00495" name="l00495"></a> 495 inline ROCKY_FUNCTIONS double3 get_moments() const

<a id="l00496" name="l00496"></a> 496 {

<a id="l00497" name="l00497"></a> 497 const cuda_particle_force&amp; prt_forces = this-&gt;model-&gt;frc[this-&gt;particle_index];

<a id="l00498" name="l00498"></a> 498 return double3 { prt_forces.mx, prt_forces.my, prt_forces.mz };

<a id="l00499" name="l00499"></a> 499 }

<a id="l00500" name="l00500"></a> 500 

<a id="l00501" name="l00501"></a> 501 inline ROCKY_FUNCTIONS void add_moments(const double3&amp; moments)

<a id="l00502" name="l00502"></a> 502 {

<a id="l00503" name="l00503"></a> 503 cuda_particle_force&amp; prt_forces = this-&gt;model-&gt;frc[this-&gt;particle_index];

<a id="l00504" name="l00504"></a> 504 backend::atomic_add(&amp;prt_forces.mx, moments.x);

<a id="l00505" name="l00505"></a> 505 backend::atomic_add(&amp;prt_forces.my, moments.y);

<a id="l00506" name="l00506"></a> 506 backend::atomic_add(&amp;prt_forces.mz, moments.z);

<a id="l00507" name="l00507"></a> 507 }

<a id="l00508" name="l00508"></a> 508 

<a id="l00509" name="l00509"></a> 509 inline ROCKY_FUNCTIONS double get_heat_transfer_rate() const

<a id="l00510" name="l00510"></a> 510 {

<a id="l00511" name="l00511"></a> 511 return this-&gt;model-&gt;particle_transfer_scalars-&gt;get_heat_transfer(this-&gt;particle_index);

<a id="l00512" name="l00512"></a> 512 }

<a id="l00513" name="l00513"></a> 513 

<a id="l00514" name="l00514"></a> 514 // Scalar Management ---------------------------------------------------------------------------

<a id="l00515" name="l00515"></a> 515 

<a id="l00516" name="l00516"></a> 516 ROCKY_FUNCTIONS [IRockyParticleScalars](structIRockyParticleScalars.xhtml) get_scalars() const

<a id="l00517" name="l00517"></a> 517 {

<a id="l00518" name="l00518"></a> 518 return { *this-&gt;model-&gt;particle_scalars, this-&gt;particle_index };

<a id="l00519" name="l00519"></a> 519 }

<a id="l00520" name="l00520"></a> 520 

<a id="l00521" name="l00521"></a> 521 ROCKY_FUNCTIONS [IRockyParticleTransferScalars](structIRockyParticleTransferScalars.xhtml) get_transfer_scalars() const

<a id="l00522" name="l00522"></a> 522 {

<a id="l00523" name="l00523"></a> 523 return { *this-&gt;model-&gt;particle_transfer_scalars, this-&gt;particle_index };

<a id="l00524" name="l00524"></a> 524 }

<a id="l00525" name="l00525"></a> 525 

<a id="l00526" name="l00526"></a> 526 ROCKY_FUNCTIONS [IRockyParticleBreakageScalars](structIRockyParticleBreakageScalars.xhtml) get_breakage_scalars() const

<a id="l00527" name="l00527"></a> 527 {

<a id="l00528" name="l00528"></a> 528 return { *this-&gt;model-&gt;particle_breakage_scalars, this-&gt;particle_index };

<a id="l00529" name="l00529"></a> 529 }

<a id="l00530" name="l00530"></a> 530 

<a id="l00531" name="l00531"></a> 531 // Constructors --------------------------------------------------------------------------------

<a id="l00532" name="l00532"></a> 532 

<a id="l00533" name="l00533"></a> 533 inline ROCKY_FUNCTIONS void reset(int index)

<a id="l00534" name="l00534"></a> 534 {

<a id="l00535" name="l00535"></a> 535 this-&gt;particle = this-&gt;model-&gt;prt + index;

<a id="l00536" name="l00536"></a> 536 const\_cast&lt;int&amp;&gt;(this-&gt;particle_index) = index;

<a id="l00537" name="l00537"></a> 537 const\_cast&lt;int&amp;&gt;(this-&gt;group_index) = -1;

<a id="l00538" name="l00538"></a> 538 }

<a id="l00539" name="l00539"></a> 539 

<a id="l00540" name="l00540"></a> 540 inline ROCKY_FUNCTIONS RockyParticle(SDeviceModel* model, const int index)

<a id="l00541" name="l00541"></a> 541 : particle_index(index)

<a id="l00542" name="l00542"></a> 542 , group_index(-1)

<a id="l00543" name="l00543"></a> 543 , particle((*model).prt + index)

<a id="l00544" name="l00544"></a> 544 , model(model)

<a id="l00545" name="l00545"></a> 545 {

<a id="l00546" name="l00546"></a> 546 }

<a id="l00547" name="l00547"></a> 547 

<a id="l00548" name="l00548"></a> 548 inline RockyParticle(cuda_host&amp; model, const int index)

<a id="l00549" name="l00549"></a> 549 : particle_index(index)

<a id="l00550" name="l00550"></a> 550 , group_index(-1)

<a id="l00551" name="l00551"></a> 551 , particle(model.prt.data() + index)

<a id="l00552" name="l00552"></a> 552 , model(model.GetHostData())

<a id="l00553" name="l00553"></a> 553 {

<a id="l00554" name="l00554"></a> 554 }

<a id="l00555" name="l00555"></a> 555 

<a id="l00556" name="l00556"></a> 556 const int particle_index;

<a id="l00557" name="l00557"></a> 557 const int group_index; // cached index

<a id="l00558" name="l00558"></a> 558 cuda_particle* particle;

<a id="l00559" name="l00559"></a> 559 SDeviceModel* model;

<a id="l00560" name="l00560"></a> 560};

<a id="l00561" name="l00561"></a> 561 

<a id="l00562" name="l00562"></a> 562// ================================================================================================

<a id="l00563" name="l00563"></a> 563// RockyParticleHost

<a id="l00564" name="l00564"></a> 564// ================================================================================================

<a id="l00565" name="l00565"></a> 565struct RockyParticleHost : RockyParticle

<a id="l00566" name="l00566"></a> 566{

<a id="l00567" name="l00567"></a> 567 bool is_released() const

<a id="l00568" name="l00568"></a> 568 {

<a id="l00569" name="l00569"></a> 569 if (this-&gt;particle-&gt;released())

<a id="l00570" name="l00570"></a> 570 {

<a id="l00571" name="l00571"></a> 571 /\* volumetric fill or custom input particles with release time 0 begins released \*/

<a id="l00572" name="l00572"></a> 572 if (this-&gt;solver_model-&gt;iteration.current_time == 0 &amp;&amp; this-&gt;get_release_time() == 0)

<a id="l00573" name="l00573"></a> 573 return false;

<a id="l00574" name="l00574"></a> 574 return true;

<a id="l00575" name="l00575"></a> 575 }

<a id="l00576" name="l00576"></a> 576 /\* unreleased particles are always disabled \*/

<a id="l00577" name="l00577"></a> 577 return false;

<a id="l00578" name="l00578"></a> 578 }

<a id="l00579" name="l00579"></a> 579 

<a id="l00580" name="l00580"></a> 580 RockyParticleHost(RockyModel* _model, const int _index)

<a id="l00581" name="l00581"></a> 581 : RockyParticle(_model-&gt;GetHostData(), _index)

<a id="l00582" name="l00582"></a> 582 , solver_model(_model)

<a id="l00583" name="l00583"></a> 583 {

<a id="l00584" name="l00584"></a> 584 }

<a id="l00585" name="l00585"></a> 585 

<a id="l00586" name="l00586"></a> 586 RockyModel* solver_model;

<a id="l00587" name="l00587"></a> 587};

[IRockyParticleBreakageScalars](structIRockyParticleBreakageScalars.xhtml)

**Definition** rocky_particle_scalars.hpp:544



[IRockyParticleScalars](structIRockyParticleScalars.xhtml)

**Definition** rocky_particle_scalars.hpp:105



[IRockyParticleTransferScalars](structIRockyParticleTransferScalars.xhtml)

**Definition** rocky_particle_scalars.hpp:407