Old Piximi polyrepo
Piximi is a free, open source web app for performing image understanding tasks. It’s written by by dozens of engineers and scientists from institutions like the Biological Research Centre Szeged, Broad Institute of MIT and Harvard, Chan Zuckerberg Initiative, ETH Zurich, and FIMM Helsinki.
Piximi's target users are computational or non-computational scientists interested in image analysis from fields like astronomy, biology, and medicine.
Both technical and non-technical contributions are welcome and encouraged! In addition to general-purpose programming tasks, there’re numerous tasks for anyone with expertise or an interest in computer graphics, computer vision, image processing, or machine learning. There’re also a number of areas that’d benefit from non-technical contributors too, including writing or improving documentation and translations, packaging example classifiers, and even providing user feedback (especially around problems in fields where current contributors lack familiarity). The Contributing article on our wiki has more information about contributing to Piximi.
This repository includes both the Piximi web app (packages/piximi
) and the handful of discrete @piximi sub-packages (packages/@piximi/*
) written concurrently or alongside the web app. The packages included in the packages directory are versioned together and simultaneously published to the NPM package repository.
@piximi/components
: generic React components@piximi/evaluate-classifier-dialog
: Piximi’sEvaluateClassifierDialog
component@piximi/fit-classifier-dialog
: Piximi’sFitClassifierDialog
component@piximi/gallery-dialog
: Piximi’sGalleryDialog
component@piximi/help-dialog
: Piximi’sHelpDialog
component@piximi/hooks
: generic React hooks@piximi/image-viewer-dialog
: Piximi’sImageViewerDialog
component@piximi/models
: Piximi’s TensorFlow.js models@piximi/navigation-drawer
: Piximi’sNavigationDrawer
component@piximi/open-example-classifier-dialog
: Piximi’sOpenExampleClassifierDialog
component@piximi/send-feedback-dialog
: Piximi’sSendFeedbackDialog
component@piximi/settings-dialog
: Piximi’sSettingsDialog
component@piximi/store
: Piximi’s Redux actions, reducers, selectors, and stores@piximi/theme
: Piximi’s Material UI theme@piximi/translations
: Piximi’s translations@piximi/types
: Piximi’s generic TypeScript definitions@piximi/upload-image-dialog
: Piximi’sUploadImageDialog
componentpiximi
: Piximi web app
Use the bootstrap
command to bootstrap the packages found in the ./packages directory:
yarn bootstrap
Use the build
command to build the packages found in the ./packages directory:
yarn build
Use the clean
command to clean the build artifacts created by “build.”
yarn clean
Use the test
command to run the unit tests found in the packages in the ./packages directory:
yarn test
Use the lerna add
command to add a dependency to one or more packages.
If a dependency is used by just one package, use the scope
option to specify the correct package name. For example:
lerna add foo --scope=@piximi/bar
adds the foo
package to the decencies of the @piximi/bar
package.
If a dependency is used by more than one package, use the scope
option to specify the correct packages and provide the peer
option to specify that the package is a peer dependency. For example:
lerna add foo --peer --scope=@piximi/bar, @piximi/baz
adds the foo
package to the peer dependencies of both the @piximi/bar
and @piximi/baz
package.
If a dependency is used by every package (e.g. TypeScript) you can omit the scope
option. For example,
lerna add foo ---peer
adds the foo
package to the peer dependencies of the packages found in packages/@piximi
and the packages/piximi
package.