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. Tutorial (advanced)
  • 5.1. Fusion with missing slices
• 6. astec_fusion
  • 6.1. Fusion method overview
  • 6.2. Multiview lightsheet microscope acquisition
  • 6.3. Important parameters in the parameter file
  • 6.4. Fusion / input data
    • 6.4.1. Input data directory names
    • 6.4.2. Input data image file names
    • 6.4.3. Input data organization examples
    • 6.4.4. Fusion / input data / multichannel acquisition
  • 6.5. Fusion / output data
    • 6.5.1. Output data directory names
    • 6.5.2. Output data file names
    • 6.5.3. Fusion / output data / multichannel acquisition
  • 6.6. Step 3 parameters: raw data cropping
  • 6.7. Step 5 parameters: image co-registration
    • 6.7.1. Fusion direct strategy
    • 6.7.2. Fusion hierarchical strategy
    • 6.7.3. Acquisitions linear co-registration
    • 6.7.4. Stacks non-linear co-registration
  • 6.8. Step 6: linear combination of co-registered image stacks
  • 6.9. Step 7: fused data cropping
  • 6.10. Fusion troubleshooting
    • 6.10.1. Fusion strategy / transformation tuning
  • 6.11. Advanced use
    • 6.11.1. Step 3: raw data cropping
• 7. astec_drift
  • 7.1. Registration score
  • 7.2. Drift prerequisite
  • 7.3. Drift / output data
  • 7.4. Drift / principle
  • 7.5. Drift / selection of corrections
  • 7.6. Drift / computation of corrections
  • 7.7. Drift / inter-stack registration
  • 7.8. Drift / disk cleaning
• 8. astec_mars
  • 8.1. Mars method overview
  • 8.2. Mars / output data
  • 8.3. Steps 1 and 4: input image pre-processing
  • 8.4. Step 2: seed extraction
  • 8.5. Step 3: seed correction
  • 8.6. Step 5 : seeded watershed
  • 8.7. A note on parameters
• 9. astec_manualcorrection
  • 9.1. Manual correction overview
  • 9.2. Manual correction / output data
    • 9.2.1. Single segmentation file correction
    • 9.2.2. Time series segmentation files correction
  • 9.3. Segmentation correction parameters
• 10. astec_astec
  • 10.1. Astec method overview
  • 10.2. Astec / output data
  • 10.3. Input image pre-processing
  • 10.4. Step 1: \(\tilde{S}_{t}\)
  • 10.5. Step 2: \(\hat{S}_{t}\)
  • 10.6. Steps 3 and 4: volume checking
  • 10.7. Steps 5 and 6: morphosnake correction
• 11. astec_postcorrection
  • 11.1. Post-correction overview
  • 11.2. Post-correction / input data
  • 11.3. Post-correction / output data
  • 11.4. Step 1: lineage pruning
  • 11.5. Step 2: division postponing
• 12. astec_intraregistration
  • 12.1. Intra-registration procedure overview
  • 12.2. astec_intraregistration additional options
  • 12.3. Intra-registration / input data
    • 12.3.1. Intra-registration / multichannel acquisition
  • 12.4. Intra-registration / output data
  • 12.5. Step 1: co-registration
  • 12.6. Step 3: template building
  • 12.7. Step 4: resampling fusion/segmentation images
  • 12.8. Step 5: 2D+t movies
  • 12.9. Step 6: 3D maximum over the 3D+t sequence
  • 12.10. Intra-registration / parameter file examples
    • 12.10.1. Intra-registration of fusion images
    • 12.10.2. Intra-registration of segmentation images
    • 12.10.3. Intra-registration of post-segmentation images
• 13. astec_embryoproperties
  • 13.1. astec_embryoproperties additional options
  • 13.2. Extracting properties from a co-registered image sequence
  • 13.3. Embryo properties output data
  • 13.4. Handling property files
  • 13.5. Diagnosis on property file
    • 13.5.1. Contact surfaces
    • 13.5.2. Lineage
    • 13.5.3. Name
    • 13.5.4. Volume
• 14. Image sequence properties
  • 14.1. Cell unique id
  • 14.2. Properties file format
  • 14.3. Properties
    • 14.3.1. Properties computed by astec_astec
    • 14.3.2. Properties computed by astec_embryoproperties
• 15. Image preprocessing
  • 15.1. Histogram based image value transformation
  • 15.2. Membrane dedicated enhancement
  • 15.3. Outer contour
  • 15.4. Some examples
    • 15.4.1. intensity_transformation = ‘identity’ and intensity_enhancement = None
    • 15.4.2. intensity_transformation = ‘normalization_to_u8’ and intensity_enhancement = None
    • 15.4.3. intensity_transformation = ‘identity’ and intensity_enhancement = ‘gace’
    • 15.4.4. intensity_transformation = ‘normalization_to_u8’ and intensity_enhancement = ‘gace’
    • 15.4.5. intensity_transformation = None and intensity_enhancement = ‘gace’
• 16. Image registration
  • 16.1. Image-to-image registration
  • 16.2. Stack-to-stack registration
• 17. Parameters
  • 17.1. Prefixed parameters
  • 17.2. Experiment parameters
    • 17.2.1. Common parameters
    • 17.2.2. Raw data directory parameters
    • 17.2.3. Fusion directory parameters
    • 17.2.4. Drift directory parameters
    • 17.2.5. Contour directory parameters
    • 17.2.6. Membrane reconstruction directory parameters
    • 17.2.7. Seed reconstruction directory parameters
    • 17.2.8. Morphosnake reconstruction directory parameters
    • 17.2.9. Mars directory parameters
    • 17.2.10. Astec directory parameters
    • 17.2.11. Post-processing directory parameters
    • 17.2.12. Intra-registration directory parameters
  • 17.3. Ace parameters
  • 17.4. Morphosnake parameters
  • 17.5. Preprocessing parameters
  • 17.6. Registration parameters
  • 17.7. Seed edition parameters
  • 17.8. Watershed parameters
  • 17.9. Diagnosis parameters
  • 17.10. astec_fusion parameters
  • 17.11. astec_drift parameters
  • 17.12. astec_intraregistration parameters
  • 17.13. astec_mars parameters
  • 17.14. astec_manualcorrection parameters
  • 17.15. astec_astec parameters
  • 17.16. astec_postcorrection parameters
• 18. Some notations
• 19. Reference API
  • 19.1. Fusion
  • 19.2. Mars
  • 19.3. Manual correction
  • 19.4. Astec
  • 19.5. Post correction
  • 19.6. Motion compensation aka intra-registration
• 20. Release notes
  • 20.1. Developer version
  • 20.2. Version 2.2.13
  • 20.3. Version 2.2.12
  • 20.4. Version 2.2.11
  • 20.5. Version 2.2.10
  • 20.6. Version 2.2.9
  • 20.7. Version 2.2.8
  • 20.8. Version 2.2.7
  • 20.9. Version 2.2.6
  • 20.10. Version 2.2.5
  • 20.11. Version 2.2.4
  • 20.12. Version 2.2.3
  • 20.13. Version 2.2.2
  • 20.14. Version 2.2.1
  • 20.15. Version 2.2.0
  • 20.16. Version 2.1.11
  • 20.17. Version 2.1.10
  • 20.18. Version 2.1.9
  • 20.19. Version 2.1.8
  • 20.20. Version 2.1.7
  • 20.21. Version 2.1.6
  • 20.22. Version 2.1.5
  • 20.23. Version 2.1.4
  • 20.24. Version 2.1.3
  • 20.25. Version 2.1.2
  • 20.26. Version 2.1.1
  • 20.27. Version 2.1.0
  • 20.28. Version 2.0.0
  • 20.29. Version 1.7.2
  • 20.30. Version 1.7.1
  • 20.31. Version 1.7.0
  • 20.32. Version 1.6.2
• 21. Publications & bibliography