Skip to content

License

Package License

The Complete Journey Python package is released under the MIT License.

MIT License

Copyright (c) 2025 James Cunningham

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Data License and Attribution

Important: Simulated Data Notice

⚠️ This package contains simulated data for educational purposes only. The data is artificially generated based on realistic grocery shopping patterns but does not represent real consumer behavior.

Data Provider Context

84.51° - http://www.8451.com/area51/

The original Complete Journey concept and data structure were developed by 84.51°. This Python package uses that structure with simulated data for educational purposes.

Citation Requirements

When using this educational dataset, please cite:

84.51°. (2015). The Complete Journey: A comprehensive view of household shopping behavior [Dataset concept]. 84.51°. http://www.8451.com/area51/
[Note: This implementation contains simulated data for educational purposes]

Data Usage Guidelines

Appropriate Uses: - ✅ Educational coursework and tutorials - ✅ Learning data analysis techniques - ✅ Data science skill development - ✅ Prototyping analytics workflows - ✅ Teaching retail analytics concepts

Not Appropriate For: - ❌ Academic research requiring real consumer data - ❌ Commercial business decisions - ❌ Market research or consumer insights - ❌ Publication in research journals - ❌ Any application requiring authentic shopping behavior data

Educational Use Only: This simulated dataset is designed specifically for learning and should not be used where real consumer data is required.

Original R Package

The original R implementation is available at:

Dependencies

This package depends on several open-source libraries:

Dependency License Purpose
pandas BSD 3-Clause Data manipulation and analysis
pyarrow Apache 2.0 Parquet file reading
importlib Python Software Foundation Resource file access (Python stdlib)

Disclaimer

Data Accuracy

While efforts have been made to preserve data integrity during format conversion:

  • The data is provided "as-is" without warranties
  • Users should validate results for critical applications
  • Any data quality issues should be reported to the package maintainers

Educational Usage

For educational and learning use:

  • Always cite the original data concept source (84.51°)
  • Clearly indicate this is simulated data when presenting analyses
  • Follow your institution's policies for educational datasets
  • Remember this data does not reflect real consumer privacy considerations since it's simulated

Commercial and Research Considerations

Important: This simulated dataset is not suitable for commercial use or academic research:

  • No Real Consumer Data: All data is artificially generated
  • Educational Purpose Only: Designed for learning, not decision-making
  • No Commercial Value: Does not represent actual market conditions
  • Research Limitations: Cannot support valid research conclusions about consumer behavior

For real data needs, contact 84.51° directly about their actual datasets and licensing terms.

Contact Information

Package Issues

For issues with the Python package:

Data Questions

For questions about the underlying dataset:

This package is independently developed and not officially affiliated with 84.51°. The package provides a Python interface with simulated data based on the Complete Journey data structure concept, but does not imply endorsement by 84.51°.

Simulated Data Disclaimer: All data in this package is artificially generated for educational purposes. No real consumer information is included, and the data should not be used for research, commercial, or decision-making purposes.

Users are responsible for ensuring their usage complies with all applicable laws, regulations, and institutional policies regarding educational dataset usage.