particle.data-class | R Documentation |
S4 class for storing and analyzing particle trajectory data from both simulations and experimental observations. This class supports different models including Vicsek and can handle both position and velocity data along with optional angle information and particle tracking capabilities for experimental data.
Objects of this class can be created in two ways:
For simulation data: Using simulate_particle
that computes particle trajectories under physical models
For experimental data: Using trajectory_data
to save particle trajectories while handling varying numbers of particles between time steps
px_list
:Object of class list
. List of x-positions at each time step.
py_list
:Object of class list
. List of y-positions at each time step.
vx_list
:Object of class list
. List of x-velocities at each time step.
vy_list
:Object of class list
. List of y-velocities at each time step.
theta_list
:Object of class listOrNULL
. Optional list of particle velocity angles at each time step.
particle_tracking
:Object of class listOrNULL
. List of data frames containing particle mappings between consecutive frames (primarily for experimental data).
data_type
:Object of class character
. Type of data: either "simulation" or "experiment".
n_particles
:Object of class numeric
. Number of particles (constant for simulation data, or a vector recording the number of particles at each time step for experimental data).
T_time
:Object of class numeric
. Total number of time steps.
D_y
:Object of class numeric
. Dimension of the output space.
model
:Object of class characterOrNULL
. Type of particle interaction model (e.g., "Vicsek"). NULL for experimental data.
sigma_0
:Object of class numericOrNULL
. Noise variance parameter used in the model. NULL for experimental data.
radius
:Object of class numericOrNULL
. Interaction radius between particles. NULL for experimental data.
Method for displaying summary information about the particle.data object.
Method for fitting the latent factor model to data using the IKF-CG algorithm, which returns a particle.est
object containing estimated parameters and predictions. See fit.particle.data
for detailed documentation.
Mengyang Gu [aut, cre], Xinyi Fang [aut], Yizi Lin [aut]
Maintainer: Mengyang Gu <mengyang@pstat.ucsb.edu>
Vicsek, T., Czirok, A., Ben-Jacob, E., Cohen, I., & Shochet, O. (1995). Novel type of phase transition in a system of self-driven particles, Physical Review Letters, 75(6), 1226.
Chat'e, H., Ginelli, F., Gr'egoire, G., Peruani, F., & Raynaud, F. (2008). Modeling collective motion: variations on the Vicsek model, The European Physical Journal B, 64(3), 451-456.
simulate_particle
for simulating particle trajectories,
trajectory_data
for saving experimantal particle trajectories,
fit.particle.data
for model fitting methods
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.