-
Yade Documentation
Authors:
Vaclav Smilauer,
Vasileios Angelidakis,
Emanuele Catalano,
Robert Caulk,
Bruno Chareyre,
William Chevremont,
Sergei Dorofeenko,
Jerome Duriez,
Nolan Dyck,
Jan Elias,
Burak Er,
Alexander Eulitz,
Anton Gladky,
Ning Guo,
Christian Jakob,
Francois Kneib,
Janek Kozicki,
Donia Marzougui,
Raphael Maurin,
Chiara Modenese,
Gary Pekmezi,
Luc Scholtes,
Luc Sibille,
Jan Stransky,
Thomas Sweijen
, et al. (2 additional authors not shown)
Abstract:
Yade is an extensible open-source framework for discrete numerical models, focused on the Discrete Element Method. The computation parts are written in c++ using a flexible object model and allowing independent implementation of new algorithms and interfaces. Python is used for rapid and concise scene construction, simulation control, postprocessing and debugging. Yade is located at yade-dem.org,…
▽ More
Yade is an extensible open-source framework for discrete numerical models, focused on the Discrete Element Method. The computation parts are written in c++ using a flexible object model and allowing independent implementation of new algorithms and interfaces. Python is used for rapid and concise scene construction, simulation control, postprocessing and debugging. Yade is located at yade-dem.org, which contains this documentation. Development is kindly hosted on launchpad and GitLab ; they are used for source code, bug tracking and source downloads and more. Building, regression tests and packages distribution are hosted on servers of the Grenoble Geomechanics group at Laboratoire 3SR, UMS Gricad and GdaĆsk University of Technology. Yade supports high precision calculations and Python 3. The development branch is on GitLab.
△ Less
Submitted 2 January, 2023;
originally announced January 2023.
-
A robust estimator of mutual information for deep learning interpretability
Authors:
Davide Piras,
Hiranya V. Peiris,
Andrew Pontzen,
Luisa Lucie-Smith,
Ningyuan Guo,
Brian Nord
Abstract:
We develop the use of mutual information (MI), a well-established metric in information theory, to interpret the inner workings of deep learning models. To accurately estimate MI from a finite number of samples, we present GMM-MI (pronounced $``$Jimmie$"$), an algorithm based on Gaussian mixture models that can be applied to both discrete and continuous settings. GMM-MI is computationally efficien…
▽ More
We develop the use of mutual information (MI), a well-established metric in information theory, to interpret the inner workings of deep learning models. To accurately estimate MI from a finite number of samples, we present GMM-MI (pronounced $``$Jimmie$"$), an algorithm based on Gaussian mixture models that can be applied to both discrete and continuous settings. GMM-MI is computationally efficient, robust to the choice of hyperparameters and provides the uncertainty on the MI estimate due to the finite sample size. We extensively validate GMM-MI on toy data for which the ground truth MI is known, comparing its performance against established mutual information estimators. We then demonstrate the use of our MI estimator in the context of representation learning, working with synthetic data and physical datasets describing highly non-linear processes. We train deep learning models to encode high-dimensional data within a meaningful compressed (latent) representation, and use GMM-MI to quantify both the level of disentanglement between the latent variables, and their association with relevant physical quantities, thus unlocking the interpretability of the latent representation. We make GMM-MI publicly available.
△ Less
Submitted 23 March, 2023; v1 submitted 31 October, 2022;
originally announced November 2022.
-
Laser Direct Writing of Visible Spin Defects in Hexagonal Boron Nitride for Applications in Spin-Based Technologies
Authors:
Yuan-Ze Yang,
Tian-Xiang Zhu,
Zhi-Peng Li,
Xiao-Dong Zeng,
Nai-Jie Guo,
Shang Yu,
Yu Meng,
Zhao-An Wang,
Lin-Ke Xie,
Zong-Quan Zhou,
Qiang Li,
**-Shi Xu,
Xiao-Ying Gao,
Wei Liu,
Yi-Tao Wang,
Jian-Shun Tang,
Chuan-Feng Li,
Guang-Can Guo
Abstract:
Optically addressable spins in two-dimensional hexagonal boron nitride (hBN) attract widespread attention for their potential advantage in on-chip quantum devices, such as quantum sensors and quantum network. A variety of spin defects have been found in hBN, but no convenient and deterministic generation methods have been reported for other defects except negatively charged boron vacancy ($V_B^-$)…
▽ More
Optically addressable spins in two-dimensional hexagonal boron nitride (hBN) attract widespread attention for their potential advantage in on-chip quantum devices, such as quantum sensors and quantum network. A variety of spin defects have been found in hBN, but no convenient and deterministic generation methods have been reported for other defects except negatively charged boron vacancy ($V_B^-$). Here we report that by using femtosecond laser direct writing technology, we can deterministically create spin defect ensembles with spectra range from 550 nm to 800 nm on nanoscale hBN flakes. Positive single-peak optically detected magnetic resonance (ODMR) signals are detected in the presence of magnetic field perpendicular to the substrate, and the contrast can reach 0.8%. With the appropriate thickness of hBN flakes, substrate and femtosecond laser pulse energy, we can deterministically and efficiently generate bright spin defect array. Our results provide a convenient deterministic method to create spin defects in hBN, which will motivate more endeavors for future researches and applications of spin-based technologies such as quantum magnetometer array.
△ Less
Submitted 11 March, 2023; v1 submitted 1 July, 2022;
originally announced July 2022.
-
Coherent control of an ultrabright single spin in hexagonal boron nitride at room temperature
Authors:
Nai-Jie Guo,
Song Li,
Wei Liu,
Yuan-Ze Yang,
Xiao-Dong Zeng,
Shang Yu,
Yu Meng,
Zhi-Peng Li,
Zhao-An Wang,
Lin-Ke Xie,
Rong-Chun Ge,
Jun-Feng Wang,
Qiang Li,
**-Shi Xu,
Yi-Tao Wang,
Jian-Shun Tang,
Adam Gali,
Chuan-Feng Li,
Guang-Can Guo
Abstract:
Hexagonal boron nitride (hBN) is a remarkable two-dimensional (2D) material that hosts solid-state spins and has great potential to be used in quantum information applications, including quantum networks. However, in this application, both the optical and spin properties are crucial for single spins but have not yet been discovered simultaneously for hBN spins. Here, we realize an efficient method…
▽ More
Hexagonal boron nitride (hBN) is a remarkable two-dimensional (2D) material that hosts solid-state spins and has great potential to be used in quantum information applications, including quantum networks. However, in this application, both the optical and spin properties are crucial for single spins but have not yet been discovered simultaneously for hBN spins. Here, we realize an efficient method for arraying and isolating the single defects of hBN and use this method to discover a new spin defect with a high probability of 85%. This single defect exhibits outstanding optical properties and an optically controllable spin, as indicated by the observed significant Rabi oscillation and Hahn echo experiments at room temperature. First principles calculations indicate that complexes of carbon and oxygen dopants may be the origin of the single spin defects. This provides a possibility for further addressing spins that can be optically controlled.
△ Less
Submitted 21 May, 2023; v1 submitted 12 December, 2021;
originally announced December 2021.
-
Clinically Translatable Direct Patlak Reconstruction from Dynamic PET with Motion Correction Using Convolutional Neural Network
Authors:
Nuobei Xie,
Kuang Gong,
Ning Guo,
Zhixing Qin,
Jianan Cui,
Zhifang Wu,
Huafeng Liu,
Quanzheng Li
Abstract:
Patlak model is widely used in 18F-FDG dynamic positron emission tomography (PET) imaging, where the estimated parametric images reveal important biochemical and physiology information. Because of better noise modeling and more information extracted from raw sinogram, direct Patlak reconstruction gains its popularity over the indirect approach which utilizes reconstructed dynamic PET images alone.…
▽ More
Patlak model is widely used in 18F-FDG dynamic positron emission tomography (PET) imaging, where the estimated parametric images reveal important biochemical and physiology information. Because of better noise modeling and more information extracted from raw sinogram, direct Patlak reconstruction gains its popularity over the indirect approach which utilizes reconstructed dynamic PET images alone. As the prerequisite of direct Patlak methods, raw data from dynamic PET are rarely stored in clinics and difficult to obtain. In addition, the direct reconstruction is time-consuming due to the bottleneck of multiple-frame reconstruction. All of these impede the clinical adoption of direct Patlak reconstruction.In this work, we proposed a data-driven framework which maps the dynamic PET images to the high-quality motion-corrected direct Patlak images through a convolutional neural network. For the patient motion during the long period of dynamic PET scan, we combined the correction with the backward/forward projection in direct reconstruction to better fit the statistical model. Results based on fifteen clinical 18F-FDG dynamic brain PET datasets demonstrates the superiority of the proposed framework over Gaussian, nonlocal mean and BM4D denoising, regarding the image bias and contrast-to-noise ratio.
△ Less
Submitted 12 September, 2020;
originally announced September 2020.
-
Penalized-likelihood PET Image Reconstruction Using 3D Structural Convolutional Sparse Coding
Authors:
Nuobei Xie,
Kuang Gong,
Ning Guo,
Zhixin Qin,
Zhifang Wu,
Huafeng Liu,
Quanzheng Li
Abstract:
Positron emission tomography (PET) is widely used for clinical diagnosis. As PET suffers from low resolution and high noise, numerous efforts try to incorporate anatomical priors into PET image reconstruction, especially with the development of hybrid PET/CT and PET/MRI systems. In this work, we proposed a novel 3D structural convolutional sparse coding (CSC) concept for penalized-likelihood PET i…
▽ More
Positron emission tomography (PET) is widely used for clinical diagnosis. As PET suffers from low resolution and high noise, numerous efforts try to incorporate anatomical priors into PET image reconstruction, especially with the development of hybrid PET/CT and PET/MRI systems. In this work, we proposed a novel 3D structural convolutional sparse coding (CSC) concept for penalized-likelihood PET image reconstruction, named 3D PET-CSC. The proposed 3D PET-CSC takes advantage of the convolutional operation and manages to incorporate anatomical priors without the need of registration or supervised training. As 3D PET-CSC codes the whole 3D PET image, instead of patches, it alleviates the staircase artifacts commonly presented in traditional patch-based sparse coding methods. Moreover, we developed the residual-image and order-subset mechanisms to further reduce the computational cost and accelerate the convergence for the proposed 3D PET-CSC method. Experiments based on computer simulations and clinical datasets demonstrate the superiority of 3D PET-CSC compared with other reference methods.
△ Less
Submitted 15 December, 2019;
originally announced December 2019.
-
Learning Personalized Representation for Inverse Problems in Medical Imaging Using Deep Neural Network
Authors:
Kuang Gong,
Kyungsang Kim,
Jianan Cui,
Ning Guo,
Ciprian Catana,
**yi Qi,
Quanzheng Li
Abstract:
Recently deep neural networks have been widely and successfully applied in computer vision tasks and attracted growing interests in medical imaging. One barrier for the application of deep neural networks to medical imaging is the need of large amounts of prior training pairs, which is not always feasible in clinical practice. In this work we propose a personalized representation learning framewor…
▽ More
Recently deep neural networks have been widely and successfully applied in computer vision tasks and attracted growing interests in medical imaging. One barrier for the application of deep neural networks to medical imaging is the need of large amounts of prior training pairs, which is not always feasible in clinical practice. In this work we propose a personalized representation learning framework where no prior training pairs are needed, but only the patient's own prior images. The representation is expressed using a deep neural network with the patient's prior images as network input. We then applied this novel image representation to inverse problems in medical imaging in which the original inverse problem was formulated as a constraint optimization problem and solved using the alternating direction method of multipliers (ADMM) algorithm. Anatomically guided brain positron emission tomography (PET) image reconstruction and image denoising were employed as examples to demonstrate the effectiveness of the proposed framework. Quantification results based on simulation and real datasets show that the proposed personalized representation framework outperform other widely adopted methods.
△ Less
Submitted 4 July, 2018;
originally announced July 2018.
-
Large-scale pedestrian flow experiments under high-density conditions
Authors:
Cheng-Jie **,
Rui Jiang,
S. C. Wong,
Dawei Li,
Ning Guo,
Wei Wang
Abstract:
Despite the vast amount of studies on pedestrian flow, the data concerning high densities are still very inadequate. We organize one large-scale pedestrian flow experiment on a ring corridor. With 278 participants, the density as high as 9 m^(-2) is reached. In the uni-directional flow, four different states are observed, including the free flow, congested state, over-congested state and hyper-con…
▽ More
Despite the vast amount of studies on pedestrian flow, the data concerning high densities are still very inadequate. We organize one large-scale pedestrian flow experiment on a ring corridor. With 278 participants, the density as high as 9 m^(-2) is reached. In the uni-directional flow, four different states are observed, including the free flow, congested state, over-congested state and hyper-congested state. The features of the hyper-congested state are similar to the "crowd turbulence" reported in the empirical data of Helbing et al., and the transition between the stopped state and the moving state can be found. The flow rates in the over-congested state are nearly constant, due to the downstream propagation of pedestrian clusters. In the bi-directional flow, three different types of lane formations are observed in the experiment: (1) three lanes are directly formed ; (2) two lanes are directly formed; (3) firstly three lanes are formed, and then they transit into two lanes. After the lane formation, some interesting phenomena have been observed, including the inhomogeneous distribution of pedestrians across the lanes, and the formation and dissipation of localized crowd. Our study is expected to help for better understanding and modeling the dynamics of high density pedestrian flow.
△ Less
Submitted 27 October, 2017;
originally announced October 2017.
-
Impact of holding umbrella on uni- and bi-directional pedestrian flow: Experiments and modeling
Authors:
Ning Guo,
Qing-Yi Hao,
Rui Jiang,
Mao-Bin Hu,
Bin Jia
Abstract:
In this paper, the impact of holding umbrella on the uni- and bi-directional flow has been investigated via experiment and modeling. In the experiments, pedestrians are required to walk clockwise/anti-clockwise in a ring-shaped corridor under normal situation and holding umbrella situation. No matter in uni- or bi-directional flow, the flow rate under holding umbrella situation decreases comparing…
▽ More
In this paper, the impact of holding umbrella on the uni- and bi-directional flow has been investigated via experiment and modeling. In the experiments, pedestrians are required to walk clockwise/anti-clockwise in a ring-shaped corridor under normal situation and holding umbrella situation. No matter in uni- or bi-directional flow, the flow rate under holding umbrella situation decreases comparing with that in normal situation. In bidirectional flow, pedestrians segregate into two opposite moving streams very quickly under normal situation, and clockwise/anti-clockwise walking pedestrians are always in the inner/outer lane due to right-walking preference. Under holding umbrella situation, spontaneous lane formation has also occurred. However, when holding umbrella, pedestrians may separate into more than two lanes. Moreover, the merge of lanes have been observed, and clockwise/anti-clockwise pedestrians are not always in the inner/outer lane. To model the flow dynamics, an improved force-based model has been proposed. The contact force between umbrellas has been taken into account. Simulation results are in agreement with the experimental ones.
△ Less
Submitted 21 December, 2015;
originally announced June 2016.
-
Esca** in couples facilitates evacuation: Experimental study and modeling
Authors:
Ning Guo,
Rui Jiang,
Mao-Bin Hu,
Jian-Xun Ding,
Zhong-Jun Ding
Abstract:
In this paper, the impact of esca** in couples on the evacuation dynamics has been investigated via experiments and modeling. Two sets of experiments have been implemented, in which pedestrians are asked to escape either in individual or in couples. The experiments show that esca** in couples can decrease the average evacuation time. Moreover, it is found that the average evacuation time gap i…
▽ More
In this paper, the impact of esca** in couples on the evacuation dynamics has been investigated via experiments and modeling. Two sets of experiments have been implemented, in which pedestrians are asked to escape either in individual or in couples. The experiments show that esca** in couples can decrease the average evacuation time. Moreover, it is found that the average evacuation time gap is essentially constant, which means that the evacuation speed essentially does not depend on the number of pedestrians that have not yet escaped. To model the evacuation dynamics, an improved social force model has been proposed, in which it is assumed that the driving force of a pedestrian cannot be fulfilled when the composition of physical forces exceeds a threshold because the pedestrian cannot keep his/her body balance under this circumstance. To model the effect of esca** in couples, attraction force has been introduced between the partners. Simulation results are in good agreement with the experimental ones.
△ Less
Submitted 16 December, 2015;
originally announced December 2015.
-
Photonic bandgap fiber bundle spectrometer
Authors:
Qu Hang,
Bora Ung,
Imran Syed,
Ning Guo,
Maksim Skorobogatiy
Abstract:
We experimentally demonstrate an all-fiber spectrometer consisting of a photonic bandgap fiber bundle and a black and white CCD camera. Photonic crystal fibers used in this work are the large solid core all-plastic Bragg fibers designed for operation in the visible spectral range and featuring bandgaps of 60nm - 180nm-wide. 100 Bragg fibers were chosen to have complimentary and partially overlap…
▽ More
We experimentally demonstrate an all-fiber spectrometer consisting of a photonic bandgap fiber bundle and a black and white CCD camera. Photonic crystal fibers used in this work are the large solid core all-plastic Bragg fibers designed for operation in the visible spectral range and featuring bandgaps of 60nm - 180nm-wide. 100 Bragg fibers were chosen to have complimentary and partially overlap** bandgaps covering a 400nm-840nm spectral range. The fiber bundle used in our work is equivalent in its function to a set of 100 optical filters densely packed in the area of ~1cm2. Black and white CCD camera is then used to capture spectrally "binned" image of the incoming light at the output facet of a fiber bundle. To reconstruct the test spectrum from a single CCD image we developed an algorithm based on pseudo-inversion of the spectrometer transmission matrix. We then study resolution limit of this spectroscopic system by testing its performance using spectrally narrow test peaks (FWHM 5nm-25nm) centered at various positions within the 450nm-700nm spectral interval. We find that the peak center wavelength can always be reconstructed within several percent of its true value regardless of the peak width or position. We believe that photonic bandgap fiber bundle-based spectrometers have a potential to become an important technology in multispectral imaging because of their simplicity (lack of moving parts), instantaneous response, and high degree of integration.
△ Less
Submitted 26 February, 2010;
originally announced March 2010.