ENH: Add a bulk mask read to MaskCompare and use it for every mask read
Los mantenedores suelen responder en 6 días
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 35/100
Línea de trabajo
Start with src/simplnx/Utilities/MaskCompareUtilities.hpp and .cpp to understand the existing mask interfaces, then inspect the listed OrientationAnalysis and SimplnxCore algorithms that bulk-read typed mask stores. Add a bulk read that reports transfer failures, route those algorithms through MaskCompare, and add the rule to docs/Code_Style_Guide.md. Done means in-core Release performance and out-of-core [ooc] tests meet the stated requirements.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Summary
Request: give MaskCompare a bulk read of a range of mask values that works for bool and uint8 masks, on in-memory and out-of-core stores, without making in-core algorithms slower. Then change every algorithm that reads a mask to read it through MaskCompare, instead of reading the typed mask stores itself.
Why: today a mask can be read in two different ways, and both are copied around the code base.
MaskCompare(MaskCompareUtilities.hpp) handlesboolanduint8masks behind one interface, but it reads one element at a time through the virtualisTrue(index),bothTrue()andbothFalse(). On an out-of-core store, each element read can load a whole chunk, so algorithms that are optimized for out-of-core data do not use it for their main loops.- Those algorithms read the mask in bulk instead. Each one checks whether the mask is a
UInt8Arrayor aBoolArray, callscopyIntoBuffer()on the matching store, and copies aboolmask through a contiguousboolscratch buffer, becausestd::vector<bool>is not contiguous. Each algorithm writes this branch itself. - A new algorithm then has to choose between a convenient helper that is slow out-of-core and a hand-written copy of the bulk pattern. Code that reads a mask only with
getDataAs<BoolArray>()getsnullptrfor auint8mask and silently ignores it.
Where it applies:
MaskCompare,BoolMaskCompare,UInt8MaskCompareandInstantiateMaskCompare()insrc/simplnx/Utilities/MaskCompareUtilities.hppand.cpp.- 27 files call
InstantiateMaskCompare()(at6dd86c67d). - These algorithms bulk-read the typed mask stores themselves. Several of them also use
MaskComparefor element access, and some handle only one of the two mask types. Each one needs to be checked:- OrientationAnalysis:
AlignSectionsMisorientation,AlignSectionsMutualInformation,BadDataNeighborOrientationCheckScanline,CAxisSegmentFeatures,ComputeFZQuaternions,EBSDSegmentFeatures,WriteStatsGenOdfAngleFile - SimplnxCore:
AlignSectionsFeatureCentroid,ComputeArrayHistogram,ComputeArrayHistogramByFeature,ComputeArrayStatistics,ComputeFeaturePhasesBinary,CreateColorMapScanline,DBSCANScanline,ErodeDilateMask,ExtractVertexGeometry
- OrientationAnalysis:
- Out-of-tree plugins, such as SimplnxReview, may contain the same pattern.
Requirements:
- The bulk read returns a
Resultfor a failed transfer. - In-core performance must not regress: compare the changed algorithms before and after in an in-core Release build.
- Out-of-core behavior must not regress: run the
[ooc]tests in the out-of-core build. - When
MaskComparehas the bulk read, add a rule todocs/Code_Style_Guide.mdthat algorithms read masks throughMaskCompare, in the same change.
The exact API (the signature of the bulk read, and whether it fills a uint8 or a bool buffer) is still open.
- Lenguaje dominante
- C++
- Estrellas
- 18
- Forks
- 15
- Merge medio
- 4 d 23 h
- PR fusionados (30 d)
- 42
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de BlueQuartzSoftware/simplnx
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
BlueQuartzSoftware/simplnx#1987 ·
Los mantenedores suelen responder en 6 días
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
BlueQuartzSoftware/simplnx#1980 ·
Los mantenedores suelen responder en 6 días
-
Testing
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
BlueQuartzSoftware/simplnx#1979 ·
Los mantenedores suelen responder en 6 días
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
BlueQuartzSoftware/simplnx#1978 ·
Los mantenedores suelen responder en 6 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
BlueQuartzSoftware/simplnx#1945 ·
Los mantenedores suelen responder en 6 días
Todos los issues de BlueQuartzSoftware/simplnx
Issues similares
-
bug triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
26.04 bug dark-mode Easy Hack impress symptom: visual
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
CollaboraOnline/online#16421 · 1 comentario ·
-
area/cs bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
ydb-platform/ydb#59881 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
Los mantenedores suelen responder en 1 día
-
documentation enhancement lua server
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100