Astec package

ASTEC, for Adaptive Segmentation and Tracking of Embryonic Cells, was first developed during L. Guignard PhD thesis [Gui15].

Its development has been pursued, and it was used to process 3D+t movies acquired by the MuViSPIM light-sheet microscope [GFL+20]. Please cite this last article if you use ASTEC.

Contents

• 1. Installation
  • 1.1. User installation (without git)
  • 1.2. User installation (with git)
  • 1.3. Developer installation (with git)
  • 1.4. Documentation update (with git)
• 2. Command line interfaces
  • 2.1. Principle
  • 2.2. Command line interfaces common options
• 3. Data organization
• 4. Tutorial
  • 4.1. Fusion parameter settings
    • 4.1.1. Setting acquisition_mirrors
    • 4.1.2. Setting acquisition_leftcamera_z_stacking
    • 4.1.3. Setting acquisition_orientation
  • 4.2. Fusion (example)
  • 4.3. Drift compensated fusion
    • 4.3.1. Stack #0 fusion (parameters)
    • 4.3.2. Stack #1 fusion (parameters)
    • 4.3.3. Drift estimation of stack #0 (parameters)
    • 4.3.4. Drift estimation of stack #1 (parameters)
    • 4.3.5. Drift estimation between stacks (parameters)
    • 4.3.6. Drift compensated fusion (parameters)
• 5. astec_fusion
  • 5.1. Fusion method overview
  • 5.2. Multiview lightsheet microscope acquisition
  • 5.3. Important parameters in the parameter file
  • 5.4. Fusion / input data
    • 5.4.1. Input data directory names
    • 5.4.2. Input data image file names
    • 5.4.3. Input data organization examples
    • 5.4.4. Fusion / input data / multichannel acquisition
  • 5.5. Fusion / output data
    • 5.5.1. Output data directory names
    • 5.5.2. Output data file names
    • 5.5.3. Fusion / output data / multichannel acquisition
  • 5.6. Step 3 parameters: raw data cropping
  • 5.7. Step 5 parameters: image co-registration
    • 5.7.1. Fusion direct strategy
    • 5.7.2. Fusion hierarchical strategy
    • 5.7.3. Acquisitions linear co-registration
    • 5.7.4. Stacks non-linear co-registration
  • 5.8. Step 6: linear combination of co-registered image stacks
  • 5.9. Step 7: fused data cropping
  • 5.10. Fusion troubleshooting
    • 5.10.1. Fusion strategy / transformation tuning
  • 5.11. Advanced use
    • 5.11.1. Step 3: raw data cropping
• 6. astec_drift
  • 6.1. Registration score
  • 6.2. Drift prerequisite
  • 6.3. Drift / output data
  • 6.4. Drift / principle
  • 6.5. Drift / selection of corrections
  • 6.6. Drift / computation of corrections
  • 6.7. Drift / inter-stack registration
  • 6.8. Drift / disk cleaning
• 7. astec_mars
  • 7.1. Mars method overview
  • 7.2. Mars / output data
  • 7.3. Steps 1 and 4: input image pre-processing
  • 7.4. Step 2: seed extraction
  • 7.5. Step 3: seed correction
  • 7.6. Step 5 : seeded watershed
  • 7.7. A note on parameters
• 8. astec_manualcorrection
  • 8.1. Manual correction overview
  • 8.2. Manual correction / output data
    • 8.2.1. Single segmentation file correction
    • 8.2.2. Time series segmentation files correction
  • 8.3. Segmentation correction parameters
• 9. astec_astec
  • 9.1. Astec method overview
  • 9.2. Astec / output data
  • 9.3. Input image pre-processing
  • 9.4. Step 1: \(\tilde{S}_{t}\)
  • 9.5. Step 2: \(\hat{S}_{t}\)
  • 9.6. Steps 3 and 4: volume checking
  • 9.7. Steps 5 and 6: morphosnake correction
• 10. astec_postcorrection
  • 10.1. Post-correction overview
  • 10.2. Post-correction / input data
  • 10.3. Post-correction / output data
  • 10.4. Step 1: lineage pruning
  • 10.5. Step 2: division postponing
• 11. astec_intraregistration
  • 11.1. Intra-registration procedure overview
  • 11.2. astec_intraregistration additional options
  • 11.3. Intra-registration / input data
    • 11.3.1. Intra-registration / multichannel acquisition
  • 11.4. Intra-registration / output data
  • 11.5. Step 1: co-registration
  • 11.6. Step 3: template building
  • 11.7. Step 4: resampling fusion/segmentation images
  • 11.8. Step 5: 2D+t movies
  • 11.9. Step 6: 3D maximum over the 3D+t sequence
  • 11.10. Intra-registration / parameter file examples
    • 11.10.1. Intra-registration of fusion images
    • 11.10.2. Intra-registration of segmentation images
    • 11.10.3. Intra-registration of post-segmentation images
• 12. astec_embryoproperties
  • 12.1. astec_embryoproperties additional options
  • 12.2. Extracting properties from a co-registered image sequence
  • 12.3. Embryo properties output data
  • 12.4. Handling property files
  • 12.5. Diagnosis on property file
    • 12.5.1. Contact surfaces
    • 12.5.2. Lineage
    • 12.5.3. Name
    • 12.5.4. Volume
• 13. Image sequence properties
  • 13.1. Cell unique id
  • 13.2. Properties file format
  • 13.3. Properties
    • 13.3.1. Properties computed by astec_astec
    • 13.3.2. Properties computed by astec_embryoproperties
• 14. Image preprocessing
  • 14.1. Histogram based image value transformation
  • 14.2. Membrane dedicated enhancement
  • 14.3. Outer contour
  • 14.4. Some examples
    • 14.4.1. intensity_transformation = ‘identity’ and intensity_enhancement = None
    • 14.4.2. intensity_transformation = ‘normalization_to_u8’ and intensity_enhancement = None
    • 14.4.3. intensity_transformation = ‘identity’ and intensity_enhancement = ‘gace’
    • 14.4.4. intensity_transformation = ‘normalization_to_u8’ and intensity_enhancement = ‘gace’
    • 14.4.5. intensity_transformation = None and intensity_enhancement = ‘gace’
• 15. Image registration
  • 15.1. Image-to-image registration
  • 15.2. Stack-to-stack registration
• 16. Parameters
  • 16.1. Prefixed parameters
  • 16.2. Experiment parameters
    • 16.2.1. Common parameters
    • 16.2.2. Raw data directory parameters
    • 16.2.3. Fusion directory parameters
    • 16.2.4. Drift directory parameters
    • 16.2.5. Contour directory parameters
    • 16.2.6. Membrane reconstruction directory parameters
    • 16.2.7. Seed reconstruction directory parameters
    • 16.2.8. Morphosnake reconstruction directory parameters
    • 16.2.9. Mars directory parameters
    • 16.2.10. Astec directory parameters
    • 16.2.11. Post-processing directory parameters
    • 16.2.12. Intra-registration directory parameters
  • 16.3. Ace parameters
  • 16.4. Morphosnake parameters
  • 16.5. Preprocessing parameters
  • 16.6. Registration parameters
  • 16.7. Seed edition parameters
  • 16.8. Watershed parameters
  • 16.9. Diagnosis parameters
  • 16.10. astec_fusion parameters
  • 16.11. astec_drift parameters
  • 16.12. astec_intraregistration parameters
  • 16.13. astec_mars parameters
  • 16.14. astec_manualcorrection parameters
  • 16.15. astec_astec parameters
  • 16.16. astec_postcorrection parameters
• 17. Some notations
• 18. Reference API
  • 18.1. Fusion
  • 18.2. Mars
  • 18.3. Manual correction
  • 18.4. Astec
  • 18.5. Post correction
  • 18.6. Motion compensation aka intra-registration
• 19. Release notes
  • 19.1. Developer version
  • 19.2. Version 2.2.11
  • 19.3. Version 2.2.10
  • 19.4. Version 2.2.9
  • 19.5. Version 2.2.8
  • 19.6. Version 2.2.7
  • 19.7. Version 2.2.6
  • 19.8. Version 2.2.5
  • 19.9. Version 2.2.4
  • 19.10. Version 2.2.3
  • 19.11. Version 2.2.2
  • 19.12. Version 2.2.1
  • 19.13. Version 2.2.0
  • 19.14. Version 2.1.11
  • 19.15. Version 2.1.10
  • 19.16. Version 2.1.9
  • 19.17. Version 2.1.8
  • 19.18. Version 2.1.7
  • 19.19. Version 2.1.6
  • 19.20. Version 2.1.5
  • 19.21. Version 2.1.4
  • 19.22. Version 2.1.3
  • 19.23. Version 2.1.2
  • 19.24. Version 2.1.1
  • 19.25. Version 2.1.0
  • 19.26. Version 2.0.0
  • 19.27. Version 1.7.2
  • 19.28. Version 1.7.1
  • 19.29. Version 1.7.0
  • 19.30. Version 1.6.2
• 20. Publications & bibliography